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