- 产品介绍
- 价格说明
- 快速入门
- 开发指南
- 用户指南
- 最佳实践
- API参考
-
SDK参考
- SDK介绍（联通用户专用）
- 应用侧JAVA SDK API参考（联通用户专用）
- 应用侧Python SDK API参考（联通用户专用）
- 设备侧Agent Lite API参考(C)（联通用户专用）
- 设备侧Agent Lite API参考(Android)（联通用户专用）
- 设备侧Agent Lite API参考(Java)（联通用户专用）
-
常见问题
- 热门问题（联通用户专用）
-
方案咨询（联通用户专用）
- 开发中心、设备接入和设备管理的差异是什么？
- IAM子用户或子项目是否可以开通物联网平台服务？
- 物联网平台支持在华为云的哪些区域开通？
- 如何成为华为IoT生态合作伙伴？
- 物联网平台支持哪些接入方式和协议？
- 华为是否提供模组/硬件终端/应用软件等？
- 设备接入模拟器HubSimulator是否能在设备管理使用？
- 设备接入服务如何获取设备数据？
- 物联网平台的应用和设备可以无限创建吗？
- 物联网平台支持批量注册设备吗？
- 物联网平台对应用和设备有消息流控吗？
- 开发中心单个应用允许接入设备数是多少？
- 数据在物联网平台的保存时间是多久？
- 物联网平台支持的DTLS加密算法有哪些？
- 物联网平台支持二进制大小端模式切换吗？
- 什么是NB-IoT？
- 物联网平台支持的硬件架构和使用的相关组件有哪些？
-
设备集成（联通用户专用）
- 如何获取设备和应用对接地址？
- 如何下载LiteOS IDE/IoT Studio?
- 物联网平台允许一个IMEI号注册多个设备吗？
- 如何设置设备名称？
- IoT设备如何激活？
- 物联网平台如何切换设备的在线/离线状态？
- 通过网关接入的子设备，平台如何识别是哪一个设备？
- deviceId、nodeId和IMEI有什么对应关系？
- Agent Lite和Agent Tiny有什么区别？
- 使用Agent Lite接入的网关设备gwbindinfo.json文件丢失如何处理？
- 运行Agent Lite Java Demo报UnsatisfiedLinkError错误怎么处理？
- 设备如何发送文件至物联网平台？
- 开发中心模拟设备如何上报负数？
- 开发中心支持哪几种省电模式？
- 开发中心支持数据转发吗？
- 开发中心没有设备分组和批量添加设备，怎么办？
- 如何检测NB网络信号？
- NB模组附着网络失败如何处理？
- NB模组绑定设备失败怎么办？
- NB模组无法正常上报数据怎么办？
- NB设备上报数据为字符串时如何转换为二进制编码？
- NB设备接入时，出现513错误？
- 为什么执行AT+CUFN=1会返回error？
- 平台向NB-IoT设备缓存下发命令，为什么设备一直收到同一条控制命令？
- AT+CGDCONT=1, CTNB是什么？
- NB-IoT设备如何选择PSM、DRX、eDRX模式？
- 应用集成（联通用户专用）
-
订阅推送（联通用户专用）
- 调用订阅接口时，回调地址如何获取？
- 应用服务器如何收到命令状态变化的通知？
- 如何获取证书？
- 回调地址可以使用域名吗？
- 订阅后消息推送失败，例如提示503如何处理？
- 应用服务器收到数据，但是平台显示推送失败？
- 应用服务器只有内网地址，能否订阅成功？
- 调用订阅接口时，提示回调地址不合法？
- 物联网平台只支持HTTPS的回调地址吗？
- 回调地址可以修改吗？
- 推送证书失效怎么处理？
- 调用删除单个订阅接口时，subscriptionId如何获取？
- 设备数据变化通知和批量设备数据变化通知的区别是什么？
- 应用服务器如何获取物联网平台推送消息时使用的地址？
- 物联网平台订阅推送是否具有重推机制？
- 为什么设备上报一条数据后应用服务器会收到多条推送？
- 在同一个应用下，平台可以将不同设备上报的数据，推送到两个服务器吗？
- NB-IoT设备已订阅消息确认和命令响应通知，为何应用服务器收不到推送消息？
- 数据上报（联通用户专用）
- 命令下发（联通用户专用）
- 产品模型/Profile（联通用户专用）
- 编解码插件（联通用户专用）
- 软/固件升级（联通用户专用）
- 文档下载
- 通用参考
链接复制成功！
SDK使用说明（联通用户专用）
非联通用户请查看设备接入服务。
SDK Demo总体架构
- Demo代码是调用SDK接口的样例代码，包括初始化及各个接口调用，仅供开发者参考。
- SDK提供JAVA方法调用物联网平台的API接口与平台通信。
- 消息推送回调使用JAVA代码实现回调接口，供平台推送消息给应用服务器时调用，应用通过继承PushMessageReceiver类并重写类中的方法接收推送消息的内容。
- Test API提供测试SDK接口的功能，主要测试SDK与平台之间的基本功能是否可用，并输出测试结果。测试时会分别使用内部测试证书和开发者设置的证书，以便排查证书问题。
NorthApiClient类方法
用于创建应用实例，是调用SDK其他接口的前提。主要方法如下：
|
方法 |
说明 |
|---|---|
|
public void setClientInfo( ClientInfo clientInfo) |
初始化NorthApiClient中的参数，ClientInfo的定义参考Clientinfo类方法。 |
|
public void setHttpConnection(int httpSocketTimeout, int httpConnectionTimeout, int maxConnectionAmount, int maxConnectionAmountPerRoute, int clearIdleTime, int httpRetryTimes) |
HTTP连接池设置，可对如下参数进行设置。
需要在initSSLConfig()或initSSLConfig(SSLConfig sslConfig)前调用。 |
|
public void initSSLConfig() |
初始化双向认证的配置，调用后才可以使用其他方法。
须知：
本方法使用了测试证书，非正式证书，且不做主机名校验，故仅在集成对接的调试阶段使用。 |
|
public void initSSLConfig(SSLConfig sslConfig) |
初始化双向认证的配置，调用后才可以使用其他方法。SSLConfig的定义参考SSLConfig类方法。
须知：
本方法用于导入证书，可以在商用阶段使用。在调用本方法前可调用setHostnameVerifier(HostnameVerifier hostnameVerifier)方法进行主机名校验，否则默认使用严格主机名校验。 |
|
public void setHostnameVerifier(HostnameVerifier hostnameVerifier) |
自定义主机名校验方法，在initSSLConfig(SSLConfig sslConfig)方法前调用，否则默认使用严格主机名校验。
须知：
|
|
public String getVersion() |
查询SDK版本号。 |
Clientinfo类方法
用于设置与物联网平台对接的基本信息。主要方法（省略get方法）如下：
|
方法 |
说明 |
|---|---|
|
public void setPlatformIp(String platformIp) |
设置物联网平台的IP地址。 |
|
public void setPlatformPort(String platformPort) |
设置物联网平台的端口，如8743。 |
|
public void setAppId(String appId) |
设置应用的appId。appId是物联网平台为第三方应用分配的身份标识，用于唯一标识一个应用。 |
|
public void setSecret(String secret) |
设置应用的secret。secret是与平台appId配套的密码。 |
NorthApiException类方法
当SDK的处理有异常，或者物联网平台对SDK的请求处理有异常时，抛出NorthApiException类方法。主要方法（省略set方法）如下：
|
方法 |
说明 |
|---|---|
|
public String geterror_code() |
获取异常的错误码，SDK自身处理异常会抛出四位数字的错误码，物联网平台处理异常会抛出六位数字的错误码。 |
|
public String getError_desc() |
获取异常错误码对应的错误描述。 |
|
public String getHttpStatusCode() |
获取异常http状态码。 本SDK封装了http restful API，因此当SDK在调用restful API异常时，会得到异常的http状态码，如404、200等。 |
|
public String getHttpReasonPhase() |
获取异常http状态码对应的原因解释（ReasonPhrase）。 如http状态码为400时，原因解释为“Not Found”；StatusCode为200时，原因解释为“OK”。 |
|
public String getHttpMessage() |
当物联网平台处理请求异常，并且异常中未包含错误码时，将该异常的内容通过本方法返回。 |
SSLConfig类方法
用于设置证书路径及密码。主要方法（省略get方法）如下：
|
方法 |
说明 |
|---|---|
|
public String setSelfCertPath(String selfCertPath) |
设置客户端的证书位置的绝对路径。 |
|
public String setSelfCertPwd(String selfCertPwd) |
设置客户端证书的密码。 |
|
public String setTrustCAPath(String trustCAPath) |
设置服务端CA证书位置的绝对路径。 |
|
public String setTrustCAPwd(String trustCAPwd) |
设置服务端CA证书的密码。 |
BasicTest类方法
用于测试证书、登录、注册设备等基本功能是否正常。方法如下：
|
方法 |
说明 |
|---|---|
|
public static void beginBasicTest(String platformIp, String platformPort, String appId, String secret, SSLConfig sslConfig) |
用户设置好平台IP、端口、appId、密码、商用证书（可选参数）后，可使用该方法测试证书、登录、注册设备等基本功能是否正常，如有异常则给出原因及建议（在控制台打印输出）。 |
