自建服务器接入.md

自建服务器接入

本文主要描述，当您使用自建服务器时，如何接入SDK。

传入自建服务器的Broker地址

SDK提供传入自建服务器Broker地址的能力，可使用以下 TXMqttConnection 或 TXShadowConnection 的初始化方式，传入Broker地址：

TXMqttConnection(String serverURI, String productID, String deviceName, String secretKey, DisconnectedBufferOptions bufferOpts, MqttClientPersistence clientPersistence, TXMqttActionCallBack callBack)
TXShadowConnection(String serverURI, String productID, String deviceName, String secretKey, DisconnectedBufferOptions bufferOpts, MqttClientPersistence clientPersistence, TXShadowActionCallBack callBack)

其中serverURI参数，即为将要传入的自建服务器Broker地址。

传入自建服务器对应的CA证书

SDK提供传入自建服务器对应的CA证书的能力，可调用AsymcSslUtils.getSocketFactory(String customCA)方法，示例代码如下：

String myCA = "您的CA证书文本"
MqttConnectOptions options = new MqttConnectOptions();
options.setSocketFactory(AsymcSslUtils.getSocketFactory(myCA));
mShadowConnection = new TXShadowConnection(testProductIDString, testDeviceNameString, testPSKString, new callback());
mShadowConnection.connect(options, null);

以上为设备及设备影子认证接入时，配置自建服务器对应CA证书的接口。

传入自建服务器对应的Websocket-MQTT连接域名

SDK提供传入自建服务器对应的Websocket-MQTT连接域名的能力，可使用以下获取 TXWebSocketClient 的方式，传入Websocket-MQTT连接域名：

TXWebSocketClient getClient(String wsUrl, String productId, String devicename)

其中wsUrl参数，即为将要传入的自建服务器Websocket-MQTT连接域名。

传入自建服务器对应的动态注册url

SDK提供传入自建服务器对应的动态注册url的能力，可使用以下 TXMqttDynreg 的初始化方式，传入动态注册url地址：

TXMqttDynreg(String dynregUrl, String productId, String productKey, String deviceName, TXMqttDynregCallback callback)

其中dynregUrl参数，即为将要传入的自建服务器动态注册url地址。

传入自建服务器的日志上报连接域名

SDK提供传入自建服务器日志上报连接域名的能力，可使用以下 TXMqttConnection 或 TXGatewayConnection 的初始化方式，传入日志上报连接域名地址：

TXMqttConnection(Context context, String serverURI, String productID, String deviceName, String secretKey,DisconnectedBufferOptions bufferOpts, MqttClientPersistence clientPersistence, Boolean mqttLogFlag, TXMqttLogCallBack logCallBack, TXMqttActionCallBack callBack, String logUrl)
TXGatewayConnection(Context context, String serverURI, String productID, String deviceName, String secretKey, DisconnectedBufferOptions bufferOpts, MqttClientPersistence clientPersistence, Boolean mqttLogFlag, TXMqttLogCallBack logCallBack, TXMqttActionCallBack callBack, String logUrl)

其中logUrl参数，即为将要传入的自建服务器日志上报连接域名。