# WMPFMiniProgramDeviceApi.registerMiniProgramDevice
需 WMPF >= 2.1.0 支持，使用前建议阅读注意事项
本接口不需要
WMPFDeviceApi.activateDevice即可使用。
接入小程序硬件生态的设备注册。
注册设备将 modelId 和 SN 与设备绑定。一旦成功后，除非更换存储芯片，否则 appId、modelId、sn 均不能更换。
# 注意事项（调用前必读）
- 注册设备成功后，会将 SN 固化至 EMMC/RPMB 分区中，标定此设备的唯一身份。sn 和 modelId 一经写入后续即不可更改。
- 此处使用的 SN，必须经过 WMPF 的 addDevice 接口作为 deviceId 注册，并与 WMPF 设备激活时使用的 deviceId 一致。
- 若 WMPF 缓存被删除重装、清理缓存或 keystone 失效，会报错
cert fail。可以清理 APK 的数据再以相同的 appId、modelId、sn调用接口重新注册即可。 - 注册过程会有网络请求，时长根据网络情况会有所不同。
- 注册是否成功以返回值里的
code为准，而不以接口调用是否成功。
# 调用参数
| 属性 | 类型 | 说明 |
|---|---|---|
| appId | String | 小程序 appId |
| modelId | String | 设备接入时从「小程序管理后台」申请获得的 model_id |
| sn | String | 设备序列号。厂商自己生成，长度不能超过 128 字节。字符只接受数字，大小写字母，下划线（*）和连字符（-）。 此处使用的 sn 必须与 WMPF 激活设备使用的 deviceId 一致 |
| snTicket | String | 通过获取设备票据接口获得 |
# 返回参数
WMPFRegisterMiniProgramDeviceResponse
| 属性 | 类型 | 说明 |
|---|---|---|
| code | int | 错误码，具体含义参加下表 |
| errMsg | String | 当 code 为 -11 时，错误详情 |
code 取值
| code 值 | 描述 |
|---|---|
| 0 | 成功 |
| -1 | 参数错误 |
| -2 | 通用 IO 错误 |
| -3 | KEY 不匹配 |
| -4 | 网络请求无回复 |
| -5 | 权限错误 |
| -6 | KEY 不可用 |
| -7 | rpmbd 服务没运行 |
| -8 | EMMC/UFS 不匹配。里面已经存在 SN |
| -9 | EMMC/UFS IO 错误 |
| -10 | 密钥不存在 |
| -11 | 其他异常，异常内容可查看 errMsg |
# 示例代码
val miniProgramDeviceApi = WMPF.getInstance().getMiniProgramDeviceApi()
val response = miniProgramDeviceApi.registerMiniProgramDevice(appId, modelId, deviceId, snTicket)
val code = response.code
val errMsg = response.errMsg
if (code == 0) {
Log.i(TAG, "registerMiniProgramDevice success")
} else {
Log.e(TAG, "registerMiniProgramDevice fail: " + errMsg)
}