RemoteAdmin:admin broadcast
From OpenSimulator
(Difference between revisions)
m (Robot: Cosmetic changes) |
|||
| Line 89: | Line 89: | ||
# invoke admin_alert: requires password and message | # invoke admin_alert: requires password and message | ||
simulator.admin_broadcast({'password': 'secret', 'message': 'the answer is 42'}) | simulator.admin_broadcast({'password': 'secret', 'message': 'the answer is 42'}) | ||
| + | </source> | ||
| + | |||
| + | === C# === | ||
| + | |||
| + | This C# example is made with the consoleapplication. | ||
| + | you need to use the XMLRPC.DLL that you can find in the opensim packadge. | ||
| + | |||
| + | <source lang="csharp"> | ||
| + | using System; | ||
| + | using System.Collections; | ||
| + | using System.Collections.Generic; | ||
| + | using System.Data; | ||
| + | using System.Linq; | ||
| + | using System.Text; | ||
| + | using Nwc.XmlRpc; | ||
| + | |||
| + | namespace ConsoleApplication1 | ||
| + | { | ||
| + | class Program | ||
| + | { | ||
| + | static void Main(string[] args) | ||
| + | { | ||
| + | var ht = new Hashtable(); | ||
| + | ht["password"] = "password"; | ||
| + | ht["message"] = "Hello World"; | ||
| + | var parameters = new List<Hashtable> { ht }; | ||
| + | var rpc = new XmlRpcRequest("admin_broadcast", parameters); | ||
| + | rpc.Invoke("http://127.0.0.1:9999"); | ||
| + | } | ||
| + | } | ||
| + | } | ||
</source> | </source> | ||
[[RemoteAdmin]] | [[RemoteAdmin]] | ||
[[RemoteAdmin:Commands]] | [[RemoteAdmin:Commands]] | ||
Revision as of 12:56, 3 May 2012
admin_broadcast remotely allows to broadcast a general alert to all agents in a region
Contents |
Enabling admin_broadcast
If not all functions are enabled, use admin_dbroadcast to enable the function in the [RemoteAdmin] section
enabled_methods = admin_broadcast,...
Parameters
Required Parameters
These parameters are required
| parameter | Description | Values |
|---|---|---|
| message | Message to be broadcasted |
Optional Parameters
There are no optional parameters
Returned Parameters
Returned Parameters
These parameters are returned by Remote Admin
| parameter | Description | Values |
|---|---|---|
| success | true when successfull | true, false |
| error | error message when not successfull |
Error messages
No error Messages
Notes
- accepted is an optional returned parameter, probably used prior to success
Example
PHP
<?php // Including the RemoteAdmin PHP class. include('RemoteAdmin.php'); // Instantiate the class with parameters identical to the Python example above $myRemoteAdmin = new RemoteAdmin('127.0.0.1', 9000, 'secret'); // Invoke admin_create_user (multiple parameters) $parameters = array('message' => 'Welcome in my region'); $myRemoteAdmin->SendCommand('admin_broadcast', $parameters); ?>
Python
# Author : DrScofield # Source : http://xyzzyxyzzy.net/2008/01/23/using-pythons-xmlrpclib-with-opensim/ # License : BSD License #!/usr/bin/python import xmlrpclib # XML-RPC URL (http_listener_port) simulatorUrl = "http://127.0.0.1:9000" # instantiate server object simulator = xmlrpclib.Server(simulatorUrl) # invoke admin_alert: requires password and message simulator.admin_broadcast({'password': 'secret', 'message': 'the answer is 42'})
C#
This C# example is made with the consoleapplication. you need to use the XMLRPC.DLL that you can find in the opensim packadge.
using System; using System.Collections; using System.Collections.Generic; using System.Data; using System.Linq; using System.Text; using Nwc.XmlRpc; namespace ConsoleApplication1 { class Program { static void Main(string[] args) { var ht = new Hashtable(); ht["password"] = "password"; ht["message"] = "Hello World"; var parameters = new List<Hashtable> { ht }; var rpc = new XmlRpcRequest("admin_broadcast", parameters); rpc.Invoke("http://127.0.0.1:9999"); } } }
