若您未使用自訂Topic通訊,RRPC支援調用預設通訊Topic與物聯網平台通訊。本文介紹RRPC預設通訊Topic和接入方法。
RRPC預設通訊Topic
RRPC預設通訊Topic格式如下:
Topic | 格式 | 說明 |
RRPC訂閱 | /sys/${YourProductKey}/${YourDeviceName}/rrpc/request/+ | 訂閱物聯網平台下發的RRPC請求訊息。 |
RRPC請求訊息 | /sys/${YourProductKey}/${YourDeviceName}/rrpc/request/${messageId} | 物聯網平台下發的RRPC請求訊息。 |
RRPC響應訊息 | /sys/${YourProductKey}/${YourDeviceName}/rrpc/response/${messageId} | 裝置上行的RRPC響應訊息。 |
Topic格式中:
- ${YourProductKey}:您裝置所屬產品的ProductKey。
- ${YourDeviceName}:您裝置的名稱。
- ${messageId}:服務端調用物聯網平台的RRpc介面向裝置下發訊息時,物聯網平台產生的唯一的RRPC訊息ID,可用於區分不同的RRPC訊息。
RRPC接入
- 物聯網平台發送RRPC訊息。
服務端調用物聯網平台的RRpc介面向裝置發送訊息。介面調用方法,請參見RRpc。
以使用Java Link SDK為例,調用方式如下:
RRpcRequest request = new RRpcRequest(); request.setProductKey("testProductKey"); request.setDeviceName("testDeviceName"); request.setRequestBase64Byte("dGhpcyBpcyBhbiBleGFtcGxl"); request.setTimeout(3000); RRpcResponse response = client.getAcsResponse(request);
說明 請登入OpenAPI開發人員門戶,線上調用RRpc介面,查看物聯網平台中多種語言的雲端SDK調用樣本。 - 裝置端返回RRPC響應的Topic。
裝置端收到RRPC請求之後,需要根據RRPC請求Topic的格式,返迴響應訊息到對應的響應Topic。
裝置端從收到訊息的Topic(
/sys/${YourProductKey}/${YourDeviceName}/rrpc/request/${messageId}
)中提取出messageId,然後拼裝出對應的RRPC響應Topic,發送響應給物聯網平台。說明 目前,僅支援裝置端返回QoS=0的RRPC響應訊息。
樣本:遠端控制樹莓派伺服器