home *** CD-ROM | disk | FTP | other *** search
/ Chip 2011 November / CHIP_2011_11.iso / Programy / Narzedzia / TeamSpeak / TeamSpeak3-Client-win32-3.0.0.exe / plugins / clientquery_plugin / examples / README.txt < prev    next >
Text File  |  2011-06-24  |  4KB  |  84 lines
  1. Interacting with the TS3 Client from other Applications or Scripts
  2. ==================================================================
  3.  
  4. How can the TS3 Client be used from the outside?
  5. ++++++++++++++++++++++++++++++++++++++++++++++++
  6.  
  7. There are two main ways to interact with the TS3 Client:
  8. - When the Client is not running, you can get information from configuration
  9.   files, and run the Client passing it parameters to e.g. make it connect to
  10.   certain servers. The "startts3client.py" and "connectbookmark.py" example
  11.   python scripts show how this works, see below for a more detailed description
  12.   of each example.
  13. - When the Client is running it listens to a tcp socket providing a service we
  14.   call ClientQuery. This can both be used to fire off commands (e.g. switch
  15.   to a certain channel), or to query information (e.g. what is my nickname)
  16.   or to register for certain events (e.g. talkStatusChange events are fired
  17.   whenever somebody starts or stop talking). The "connectinfo.py" and "demo.py"
  18.   examples show you ways this can be used.
  19.  
  20. Some more information about ClientQuery
  21. +++++++++++++++++++++++++++++++++++++++
  22.  
  23. The ClientQuery plugin offers a telnet interface on localhost:25639 to remote
  24. control the TeamSpeak client. This allows an application to integrate with the
  25. TeamSpeak client by connecting to the ClientQuery port.
  26.  
  27. Here is an example where we connect to the ClientQuery port via telnet:
  28. $ telnet localhost 25639
  29. > TS3 Client
  30. > Welcome to the TeamSpeak 3 ClientQuery interface, type "help" for a list of
  31. > commands and "help <command>" for information on a specific command.
  32. > selected schandlerid=1
  33.  
  34. As also noted in the output, the "help" command can be used to learn which
  35. commands are available, and "help command" will tell you more information about
  36. the specified command. This information is also available in text file form in
  37. the "plugins/clientquery_plugin" folder in your TS3 Client Installation.
  38.  
  39. In addition to actively sending commands and waiting for the reply, one can
  40. register for a set of events if the integrating application needs to be notified
  41. by certain actions in the client. To reduce overhead, no notifications are sent
  42. by default. See 'help clientnotifyregister' on how to register for specific
  43. notifications.
  44.  
  45.  
  46. What do the Examples do that are provided?
  47. ++++++++++++++++++++++++++++++++++++++++++
  48.  
  49. The Python scripts in the examples directory provide some examples on how to
  50. interact with the TS3 Client from your scripts or applications.
  51.  
  52. Python verson 2.7 is used for these example scripts.
  53.  
  54. connectinfo.py
  55. --------------
  56. Checks if I am running a TS3 client, then proceeds to retrieve the server IP,
  57. server password, channel name and channel password I am currently in.
  58. This info could be used to invite somebody to join me on teamspeak.
  59.  
  60. startts3client.py
  61. -----------------
  62. Starts a TeamSpeak client and connects to the specified server and channel.
  63. This shows how, uppon receiving the data found in "connectinfo.py", a differnt
  64. client would start a TS3 Client and connect to the specified server and channel.
  65.  
  66. connectbookmark.py
  67. ------------------
  68. Lists the servers I have bookmarked, and shows how to start up TeamSpeak and
  69. connect to one of these bookmarks. This could be used to present a user that has
  70. TeamSpeak installed but currently not running a choice of his own favorite servers
  71. to join from within a game.
  72.  
  73. demo.py
  74. -------
  75. More advanced demonstration on how to monitor users on multiple server tabs.
  76. Shows when users join or leave your channel and start or stop talking.
  77. Demonstrates how to filter clients by their unique id to synchronize with
  78. in-game users.
  79.  
  80. Other
  81. -----
  82. The two files "clientquery.py" and "ts3paths.py" are not stand alone examples but
  83. rather contain helper functions that the above examples use.
  84.