# WMPFDeviceApi.registerDeviceActivationOutdatedEventListener
需 WMPF >= 2.2.0 支持,使用前建议阅读注意事项
用于注册设备激活状态过期(且自动续期失败)事件的回调。
- 可以使用
WMPFDeviceApi.unregisterDeviceActivationOutdatedEventListener
反注册。
激活过期一般有以下情况:
- 设备激活会有一天左右的有效期。过期后会尝试自动续期,如果续期失败(例如无网络等)会回调。
- 如果相同 deviceId 在其他设备上激活,当前设备的激活态会立刻过期。过期后会尝试自动续期,如果续期失败(例如无网络等)会回调。
注意:不建议开发者直接在该接口回调后直接调用激活接口。WMPF 本身会尝试自动续期,如果自动续期失败,大概率是当时网络不通,此时开发者再调用激活很能保证可以成功。建议应在网络状态变化或有用户操作时重试。
# 调用参数
参数 | 类型 | 说明 | 最低版本 |
---|---|---|---|
handler | AbstractOnDeviceActivationOutdatedEventListener | 回调函数类 |
# 回调参数
参数 | 类型 | 说明 | 最低版本 |
---|---|---|---|
message | String | 消息内容 |
# 示例代码
val val deviceApi = WMPF.getInstance().getDeviceApi()
deviceApi.registerDeviceActivationOutdatedEventListener(object :
AbstractOnDeviceActivationOutdatedEventListener() {
override fun onInvoke(p0: IPCVoid) { // 参数可忽略
// 建议在网络状态变化或有用户操作时重试
onNetworkStatusChanged {
WMPF.getInstance().deviceApi.activateDevice()
}
}
})