• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    迪恩网络公众号

TheHolyWaffle/TeamSpeak-3-Java-API: A Java wrapper of TeamSpeak's 3 server q ...

原作者: [db:作者] 来自: 网络 收藏 邀请

开源软件名称(OpenSource Name):

TheHolyWaffle/TeamSpeak-3-Java-API

开源软件地址(OpenSource Url):

https://github.com/TheHolyWaffle/TeamSpeak-3-Java-API

开源编程语言(OpenSource Language):

Java 100.0%

开源软件介绍(OpenSource Introduction):

TeamSpeak 3 Java API

Build Status Maven Central Javadocs Gitter

A Java wrapper of the TeamSpeak 3 Server Query API

Features

  • Contains almost all server query functionality! (see TeamSpeak 3 Server Query Manual)
  • Built-in keep alive method
  • Threaded event-based system
  • Both synchronous and asynchronous implementations available
  • Can be set up to reconnect and automatically resume execution after a connection problem
  • Utilizes SLF4J for logging abstraction and integrates with your logging configuration

Getting Started

Download

  • Option 1 (Standalone Jar):

    Download the latest release and add this jar to the buildpath of your project.

  • Option 2 (Maven):

    Add the following to your pom.xml:

    <dependency>
        <groupId>com.github.theholywaffle</groupId>
        <artifactId>teamspeak3-api</artifactId>
        <version>...</version>
    </dependency>

    This API utilizes SLF4J for logging purposes and doesn't come shipped with a default logging implementation, if you use Maven instead of the standalone jar. You will manually have to add one via Maven to get any logging going, if you don't have one already.

    The easiest way to do so is to just add SimpleLogger to your project, which also supports configuration via config file (needs to be shipped as a resource with your jar), if you want to log DEBUG messages for instance (e.g. raw client-server communication).

    See this configuration example for SimpleLogger. Add the following to your pom.xml to get started:

    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-simple</artifactId>
      <version>1.7.25</version>
    </dependency>

    You can however choose whichever logging framework suits your needs best. Just add your logging framework and the corresponding binding to your pom.xml.

Usage

All functionality is contained in the TS3Api object.

  1. Create a TS3Config object and customize it.
  2. Create a TS3Query object with your TS3Config as argument.
  3. Call TS3Query#connect() to connect to the server.
  4. Call TS3Query#getApi() to get an TS3Api object.
  5. Do whatever you want with this api :)

Example

final TS3Config config = new TS3Config();
config.setHost("77.77.77.77");

final TS3Query query = new TS3Query(config);
query.connect();

final TS3Api api = query.getApi();
api.login("serveradmin", "serveradminpassword");
api.selectVirtualServerById(1);
api.setNickname("PutPutBot");
api.sendChannelMessage("PutPutBot is online!");
...

More examples

here

Extra notes

FloodRate

Only use FloodRate.UNLIMITED if you are sure that your query account is whitelisted (query_ip_whitelist.txt in Teamspeak server folder). If not, use FloodRate.DEFAULT. The server will temporarily ban your account if you send too many commands in a short period of time. For more info on this, check the TeamSpeak 3 Server Query Manual, page 6.

TS3Config Settings

Option Description Method signature Default value Required
Host/IP IP/Host of TeamSpeak 3 server. setHost(String) yes
QueryPort Query port of TeamSpeak 3 server. setQueryPort(int) 10011 no
FloodRate Prevents possible spam to the server. setFloodRate(FloodRate) FloodRate.DEFAULT no
Communications logging Log client-server communication. setEnableCommunicationsLogging(boolean) false no
Command timeout Time until a command waiting for a response fails setCommandTimeout(int) 4000 (ms) no

Questions or bugs?

Please let us know here. We'll try to help you as soon as we can.

If you just have a simple question or want to talk to us about something else, please join the repository chat on Gitter.




鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
热门推荐
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap