|
User Manual
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Server APIGet Server Running Status from the files
Get Server Running Status from the filesWhen a chat server is running, some parameters are stored in text files which can be read by your application. Useful information can be extracted from them. This feature is included in the standard version of 123 Flash Chat. Get numbers To obtain a current connection number, the logon user number and the room number from a record file, use the following format: This file will real-timely change according to the chat room status. Format: < connection number >|<logon user number>|<room numbers> Get username list of each roomYou can display the user name list of each room on your webpage by retrieving data from "room_*.txt". In the <123 installed directory>/server/data/default/, you can find the following files: Send command to server to push or query the real-time data This feature can be very handy for an advanced user. In "<123flashchat installed directory>/server/etc/groups/default/server.xml" file you will find: The socket message string being sent is in standard syntax which will appear as shown below: Note:Remember to terminate XML-commands with a zero byte. add_room Rooms can be added on the fly using the 'add room' command.
A full sample of this command is shown below: <?xml version="1.0" encoding="UTF-8"?><Command group="default" api_pwd="3874-3459-9293-2194" type="add_room" name="test room" owner="aaa" desc="room for test" max="200" speaker="bbb" member="false" pwd="" passallmessage="true" > For advanced details, please check webpage: del_roomRooms can be deleted dynamically using this command.
A full sample of this command can be seen below: edit_roomRooms can be edited dynamically using this command. The following parameters are indispensable:
broadcast This command will broadcast messages to every logon user, whether or not they have entered their username or entered a room.
private_messageThis allows a private message to be sent to a specific user.
A full sample of this command can be seen below: <?xml version="1.0" encoding="UTF-8"?><Command group="default" api_pwd="3874-3459-9293-2194" type="private_message" dest_uid="test" msg="hello world" emotion="e2" owner_uid="admin" owner_nick="admin" b="1" i="1" u="1" color="0xff00ff" /> start group
A full sample of this command can be seen below: stop group
A full sample of this command can be seen below: php sample codeHow to use above server APIs with php to send command to chat server, here is the sample code: <?php $host = "127.0.0.1"; $port = 51127; $apiCommand = '<?xml version="1.0" encoding="UTF-8"?><Command group="default" api_pwd="3874-3459-9293-2194" type="add_room" name="flashchat" owner="flashchat" desc="flashchat" max="200" />'; $result = ""; $resultDoc = ""; $fp = @fsockopen($host, $port, &$errno, &$errstr, 2); if(!$fp) { echo "Failed to excute api command,maybe host chat server is not started"; } else { fputs($fp,$apiCommand."\0"); while (!feof($fp)) { $resultDoc .= fgets($fp, 1024); $resultDoc = rtrim($resultDoc); } $parser = xml_parser_create("UTF-8"); xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0); xml_parser_set_option($parser, XML_OPTION_SKIP_WHITE, 1); if (!xml_parse_into_struct($parser, $resultDoc, $values, $tags)) { printf("XML error: %s at line %d while parsing entity n", xml_error_string(xml_get_error_code($parser)), xml_get_current_line_number($parser)); echo "xml parse error"; } else { print_r($values); xml_parser_free($parser); fclose($fp); } } ?>
Related links:
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
 |
 |
Home | About | Demo | Features | Download | Order | FAQ | Support | Reviews | Affiliate | Links | Sitemap | Community | Blog