From 5f4a309077f8c1ccf2cbedf3b408bb1b84378f0e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=9D=9C=E6=99=BA=E6=B5=B7?= Date: Thu, 19 Jan 2023 11:09:32 +0000 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E5=A4=8D1018=E5=88=86=E6=94=AF?= =?UTF-8?q?=E6=96=87=E6=A1=A3=E4=B8=8D=E4=B8=80=E8=87=B4=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 杜智海 --- ...s-apis-continuation-continuationManager.md | 86 ++++++------------- 1 file changed, 28 insertions(+), 58 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-continuation-continuationManager.md b/zh-cn/application-dev/reference/apis/js-apis-continuation-continuationManager.md index b2d36361de..3564cc50ad 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-continuation-continuationManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-continuation-continuationManager.md @@ -155,8 +155,6 @@ registerContinuation(callback: AsyncCallback\): void; 注册流转管理服务，并获取对应的注册token，无过滤条件，使用AsyncCallback方式作为异步方法。 -**需要权限**：ohos.permission.DISTRIBUTED_DATASYNC - **系统能力**：SystemCapability.Ability.DistributedAbilityManager **参数：** @@ -198,8 +196,6 @@ registerContinuation(options: ContinuationExtraParams, callback: AsyncCallback\< 连接流转管理服务，并获取对应的注册token，使用AsyncCallback方式作为异步方法。 -**需要权限**：ohos.permission.DISTRIBUTED_DATASYNC - **系统能力**：SystemCapability.Ability.DistributedAbilityManager **参数：** @@ -245,8 +241,6 @@ registerContinuation(options?: ContinuationExtraParams): Promise\; 连接流转管理服务，并获取对应的注册token，使用Promise方式作为异步方法。 -**需要权限**：ohos.permission.DISTRIBUTED_DATASYNC - **系统能力**：SystemCapability.Ability.DistributedAbilityManager **参数：** @@ -298,7 +292,7 @@ on(type: "deviceConnect", callback: Callback\): void; 异步方法，监听设备连接状态，使用Callback形式返回连接的设备信息。 -> 从API version 9开始不再维护，建议使用[on](#continuationmanagerondeviceselected9)替代。 +> 从API version 9开始不再维护，建议使用[on](#continuationmanagerondeviceconnect9)替代。 **系统能力**：SystemCapability.Ability.DistributedAbilityManager @@ -337,7 +331,7 @@ on(type: "deviceDisconnect", callback: Callback\): void; 异步方法，监听设备断开状态，使用Callback形式返回断开的设备信息。 -> 从API version 9开始不再维护，建议使用[on](#continuationmanagerondeviceunselected9)替代。 +> 从API version 9开始不再维护，建议使用[on](#continuationmanagerondevicedisconnect9)替代。 **系统能力**：SystemCapability.Ability.DistributedAbilityManager @@ -374,7 +368,7 @@ off(type: "deviceConnect", callback?: Callback\): void; 异步方法，取消监听设备连接状态，使用Callback形式返回连接的设备信息。 -> 从API version 9开始不再维护，建议使用[off](#continuationmanageroffdeviceselected9)替代。 +> 从API version 9开始不再维护，建议使用[off](#continuationmanageroffdeviceconnect9)替代。 **系统能力**：SystemCapability.Ability.DistributedAbilityManager @@ -413,7 +407,7 @@ off(type: "deviceDisconnect", callback?: Callback\): void; 异步方法，取消监听设备断开状态，使用Callback形式返回连接的设备信息。 -> 从API version 9开始不再维护，建议使用[off](#continuationmanageroffdeviceunselected9)替代。 +> 从API version 9开始不再维护，建议使用[off](#continuationmanageroffdevicedisconnect9)替代。 **系统能力**：SystemCapability.Ability.DistributedAbilityManager @@ -444,21 +438,19 @@ off(type: "deviceDisconnect", callback?: Callback\): void; }); ``` -## continuationManager.on("deviceSelected")9+ +## continuationManager.on("deviceConnect")9+ -on(type: "deviceSelected", token: number, callback: Callback\>): void; +on(type: "deviceConnect", token: number, callback: Callback\>): void; 异步方法，监听设备连接状态，使用Callback形式返回连接的设备信息。 -**需要权限**：ohos.permission.DISTRIBUTED_DATASYNC - **系统能力**：SystemCapability.Ability.DistributedAbilityManager **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | type | string | 是 | 监听的事件类型，固定值"deviceSelected"。 | + | type | string | 是 | 监听的事件类型，固定值"deviceConnect"。 | | token | number | 是 | 注册后的token。 | | callback | Callback\> | 是 | 当用户从设备选择模块中选择设备时调用，返回设备ID、设备类型和设备名称供开发者使用。 | @@ -477,12 +469,12 @@ on(type: "deviceSelected", token: number, callback: Callback\ { - console.info('onDeviceSelected len: ' + data.length); + continuationManager.on("deviceConnect", token, (data) => { + console.info('onDeviceConnect len: ' + data.length); for (let i = 0; i < data.length; i++) { - console.info('onDeviceSelected deviceId: ' + JSON.stringify(data[i].id)); - console.info('onDeviceSelected deviceType: ' + JSON.stringify(data[i].type)); - console.info('onDeviceSelected deviceName: ' + JSON.stringify(data[i].name)); + console.info('onDeviceConnect deviceId: ' + JSON.stringify(data[i].id)); + console.info('onDeviceConnect deviceType: ' + JSON.stringify(data[i].type)); + console.info('onDeviceConnect deviceName: ' + JSON.stringify(data[i].name)); } }); } catch (err) { @@ -490,23 +482,21 @@ on(type: "deviceSelected", token: number, callback: Callback\9+ +## continuationManager.on("deviceDisconnect")9+ -on(type: "deviceUnselected", token: number, callback: Callback\>): void; +on(type: "deviceDisconnect", token: number, callback: Callback\>): void; 异步方法，监听设备断开状态，使用Callback形式返回断开的设备信息。 -**需要权限**：ohos.permission.DISTRIBUTED_DATASYNC - **系统能力**：SystemCapability.Ability.DistributedAbilityManager **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | type | string | 是 | 监听的事件类型，固定值"deviceUnselected"。 | + | type | string | 是 | 监听的事件类型，固定值"deviceDisconnect"。 | | token | number | 是 | 注册后的token。 | - | callback | Callback\> | 是 | 当用户从设备选择模块中断开设备时调用，返回设备ID、设备类型和设备名称供开发者使用。 | + | callback | Callback\> | 是 | 当用户从设备选择模块中断开设备时调用，返回设备ID供开发者使用。 | **错误码：** @@ -523,35 +513,31 @@ on(type: "deviceUnselected", token: number, callback: Callback\ { - console.info('onDeviceUnselected len: ' + data.length); + continuationManager.on("deviceDisconnect", token, (data) => { + console.info('onDeviceDisconnect len: ' + data.length); for (let i = 0; i < data.length; i++) { - console.info('onDeviceUnselected deviceId: ' + JSON.stringify(data[i].id)); - console.info('onDeviceUnselected deviceType: ' + JSON.stringify(data[i].type)); - console.info('onDeviceUnselected deviceName: ' + JSON.stringify(data[i].name)); + console.info('onDeviceDisconnect deviceId: ' + JSON.stringify(data[i])); } - console.info('onDeviceUnselected finished.'); + console.info('onDeviceDisconnect finished.'); }); } catch (err) { console.error('on failed, cause: ' + JSON.stringify(err)); } ``` -## continuationManager.off("deviceSelected")9+ +## continuationManager.off("deviceConnect")9+ -off(type: "deviceSelected", token: number): void; +off(type: "deviceConnect", token: number): void; 取消监听设备连接状态。 -**需要权限**：ohos.permission.DISTRIBUTED_DATASYNC - **系统能力**：SystemCapability.Ability.DistributedAbilityManager **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | type | string | 是 | 取消监听的事件类型，固定值"deviceSelected"。 | + | type | string | 是 | 取消监听的事件类型，固定值"deviceConnect"。 | | token | number | 是 | 注册后的token。 | **错误码：** @@ -569,27 +555,25 @@ off(type: "deviceSelected", token: number): void; ```ts let token = 1; try { - continuationManager.off("deviceSelected", token); + continuationManager.off("deviceConnect", token); } catch (err) { console.error('off failed, cause: ' + JSON.stringify(err)); } ``` -## continuationManager.off("deviceUnselected")9+ +## continuationManager.off("deviceDisconnect")9+ -off(type: "deviceUnselected", token: number): void; +off(type: "deviceDisconnect", token: number): void; 取消监听设备断开状态。 -**需要权限**：ohos.permission.DISTRIBUTED_DATASYNC - **系统能力**：SystemCapability.Ability.DistributedAbilityManager **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | type | string | 是 | 取消监听的事件类型，固定值"deviceUnselected"。 | + | type | string | 是 | 取消监听的事件类型，固定值"deviceDisconnect"。 | | token | number | 是 | 注册后的token。 | **错误码：** @@ -607,7 +591,7 @@ off(type: "deviceUnselected", token: number): void; ```ts let token = 1; try { - continuationManager.off("deviceUnselected", token); + continuationManager.off("deviceDisconnect", token); } catch (err) { console.error('off failed, cause: ' + JSON.stringify(err)); } @@ -761,8 +745,6 @@ startContinuationDeviceManager(token: number, callback: AsyncCallback\): v 拉起设备选择模块，可显示组网内可选择设备列表信息，无过滤条件，使用AsyncCallback方式作为异步方法。 -**需要权限**：ohos.permission.DISTRIBUTED_DATASYNC - **系统能力**：SystemCapability.Ability.DistributedAbilityManager **参数：** @@ -804,8 +786,6 @@ startContinuationDeviceManager(token: number, options: ContinuationExtraParams, 拉起设备选择模块，可显示组网内可选择设备列表信息，使用AsyncCallback方式作为异步方法。 -**需要权限**：ohos.permission.DISTRIBUTED_DATASYNC - **系统能力**：SystemCapability.Ability.DistributedAbilityManager **参数：** @@ -851,8 +831,6 @@ startContinuationDeviceManager(token: number, options?: ContinuationExtraParams) 拉起设备选择模块，可显示组网内可选择设备列表信息，使用Promise方式作为异步方法。 -**需要权限**：ohos.permission.DISTRIBUTED_DATASYNC - **系统能力**：SystemCapability.Ability.DistributedAbilityManager **参数：** @@ -1000,8 +978,6 @@ updateContinuationState(token: number, deviceId: string, status: DeviceConnectSt 通知设备选择模块，更新当前的连接状态，使用AsyncCallback方式作为异步方法。 -**需要权限**：ohos.permission.DISTRIBUTED_DATASYNC - **系统能力**：SystemCapability.Ability.DistributedAbilityManager **参数：** @@ -1046,8 +1022,6 @@ updateContinuationState(token: number, deviceId: string, status: DeviceConnectSt 通知设备选择模块，更新当前的连接状态，使用Promise方式作为异步方法。 -**需要权限**：ohos.permission.DISTRIBUTED_DATASYNC - **系统能力**：SystemCapability.Ability.DistributedAbilityManager **参数：** @@ -1183,8 +1157,6 @@ unregisterContinuation(token: number, callback: AsyncCallback\): void; 解注册流转管理服务，传入注册时获取的token进行解注册，使用AsyncCallback方式作为异步方法。 -**需要权限**：ohos.permission.DISTRIBUTED_DATASYNC - **系统能力**：SystemCapability.Ability.DistributedAbilityManager **参数：** @@ -1226,8 +1198,6 @@ unregisterContinuation(token: number): Promise\; 解注册流转管理服务，传入注册时获取的token进行解注册，使用Promise方式作为异步方法。 -**需要权限**：ohos.permission.DISTRIBUTED_DATASYNC - **系统能力**：SystemCapability.Ability.DistributedAbilityManager **参数：** -- GitLab