LibGDX网络(Networking)

LibGDX包括一些跨平台网络操作的类。 这些类通常被称为Gdx.net (source)

特征

1. 跨平台HTTP请求
2. 支持多平台TCP客户端和服务器套接字（不包括GWT），可配置设置
3. 针对低延迟的优化TCP客户端和服务器设置
4. 跨平台浏览器访问.(例如：您可以在游戏中创建一个链接到您的网站，之后在所有平台上都能通过浏览器打开链接到您的网站.)

实现

类说明：
1.Net.java 是用于跨平台网络的接口。 这是您可以获得与网络通信所需的对象。
Socket.java 是一个提供了远程套接字地址，连接状态以及通过java.io.InputStream和java.io.OutputStream来使用套接字的接口。
SocketHints.java 是一个用于配置TCP客户端套接字的类.
ServerSocket.java 是用于创建TCP服务器套接字的接口。 它提供了标准的accept（）方法来获取连接的TCP客户端。
ServerSocketHints.java是用于配置TCP服务器套接字的类。
HttpStatus.java 为查看返回的状态代码提供服务。
HttpParameterUtils.java是一个用于为HTTP请求提供实用方法的类。
HttpRequestBuilder是一个帮助创建HttpRequests的类。

要创建一个TCP客户端套接字使用以下代码片段：

Socket socket = Gdx.net.newClientSocket(Protocol protocol, String host, int port, SocketHints hints);

要创建一个TCP服务端

ServerSocket server = Gdx.net.newServerSocket(Protocol protocol, int port, ServerSocketHints hints);

要发送一个HTTP 请求：

HttpRequestBuilder requestBuilder = new HttpRequestBuilder();
HttpRequest httpRequest = requestBuilder.newRequest().method(HttpMethods.GET).url("http://www.google.de").build();
Gdx.net.sendHttpRequest(httpRequest, httpResponseListener);

要发送具有参数的GET HTTP请求，请使用以下命令：

HttpRequestBuilder requestBuilder = new HttpRequestBuilder();
HttpRequest httpRequest = requestBuilder.newRequest().method(HttpMethods.GET).url("http://www.google.de").content("q=libgdx&example=example").build();
Gdx.net.sendHttpRequest(httpRequest, httpResponseListener);

使用系统浏览器打开地址:

Gdx.net.openURI(String URI)

注意：
在不同平台上进行网络连接时，需要注意各种注意事项。

1. TCP客户端和服务器套接字在GWT上不起作用。这是由于java.net在GWT上不被支持，并且在这一点上除了websockets之外还没有可行的替代方案。
2. 在headless 平台上，Android Daydreams或Android Live壁纸不支持打开浏览器，这是由于实现或者平台的限制.
3. 在Android上：您必须在AndroidManifest.xml文件中声明以下权限才能访问网络：
4. 在Android上：无法禁用严格模式，不要在主线程上的访问网络。这是为了防止网络操作挂起主线程。see here
5. 当你的平台是手机设备时，注意实现网络的方式, 无线网络本身就是大功率输出(耗电)。 还要注意可能在1G/2G/3G/4G LTE网络上施加的数据限制。 LibGDX配置优化允许低延迟，但仍具有TCP的优点。
6. 支持的网络配置在后端和java实现之间有所不同。
7. 发送和接收数据时，电池消耗属于正常现象
8. 确保为POST请求设置Content-Type头。 并非所有的后端都默认为相同的值（由于底层实现的差异）。 这个头的最常见的值是application / x-www-form-urlencoded; 但是，根据您发送的数据类型，您可能需要一个不同的值（例如application / xml或application / json）。

See also
关于移动数据电池效率的文章
Gdx.net类的源代码