From 3d3c18d5a2835eab0f5da63bb796b8ce5f42846e Mon Sep 17 00:00:00 2001 From: HelloCrease Date: Fri, 29 Jul 2022 12:11:20 +0800 Subject: [PATCH] update docs Signed-off-by: HelloCrease --- ...js-apis-accessibility-extension-context.md | 102 +++---- ...plication-AccessibilityExtensionAbility.md | 94 +++---- .../reference/apis/js-apis-device-manager.md | 254 +++++++++--------- 3 files changed, 225 insertions(+), 225 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-accessibility-extension-context.md b/zh-cn/application-dev/reference/apis/js-apis-accessibility-extension-context.md index a9c61d030a..affa083e89 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-accessibility-extension-context.md +++ b/zh-cn/application-dev/reference/apis/js-apis-accessibility-extension-context.md @@ -12,7 +12,7 @@ AccessibilityExtensionContext模块提供扩展的上下文的能力，包括允 ## 导入模块 ```js -import AccessibilityExtensionAbility from './@ohos.application.AccessibilityExtensionAbility' +import AccessibilityExtensionAbility from '@ohos.application.AccessibilityExtensionAbility' ``` ## FocusDirection @@ -21,13 +21,13 @@ import AccessibilityExtensionAbility from './@ohos.application.AccessibilityExte **系统能力**：以下各项对应的系统能力均为 SystemCapability.Barrierfree.Accessibility.Core -| 名称 | 描述 | -| -------- | -------- | -| up | 表示向上查询。 | -| down | 表示向上查询。 | -| left | 表示向左查询。 | -| right | 表示向右查询。 | -| forward | 表示向前查询。 | +| 名称 | 描述 | +| -------- | ------- | +| up | 表示向上查询。 | +| down | 表示向上查询。 | +| left | 表示向左查询。 | +| right | 表示向右查询。 | +| forward | 表示向前查询。 | | backward | 表示向后查询。 | ## FocusType @@ -36,10 +36,10 @@ import AccessibilityExtensionAbility from './@ohos.application.AccessibilityExte **系统能力**：以下各项对应的系统能力均为 SystemCapability.Barrierfree.Accessibility.Core -| 名称 | 描述 | -| -------- | -------- | +| 名称 | 描述 | +| ------------- | ----------- | | accessibility | 表示无障碍的焦点类型。 | -| normal | 表示普通的焦点类型。 | +| normal | 表示普通的焦点类型。 | ## Rect @@ -49,12 +49,12 @@ import AccessibilityExtensionAbility from './@ohos.application.AccessibilityExte ### 参数 -| 名称 | 参数类型 | 可读 | 可写 | 说明 | -| ------ | -------- | ---- | ---- | ------------------ | -| left | number | 是 | 否 | 矩形区域的左边界。 | -| top | number | 是 | 否 | 矩形区域的上边界。 | -| width | number | 是 | 否 | 矩形区域的宽度。 | -| height | number | 是 | 否 | 矩形区域的高度。 | +| 名称 | 参数类型 | 可读 | 可写 | 说明 | +| ------ | ------ | ---- | ---- | --------- | +| left | number | 是 | 否 | 矩形区域的左边界。 | +| top | number | 是 | 否 | 矩形区域的上边界。 | +| width | number | 是 | 否 | 矩形区域的宽度。 | +| height | number | 是 | 否 | 矩形区域的高度。 | ## WindowType @@ -62,10 +62,10 @@ import AccessibilityExtensionAbility from './@ohos.application.AccessibilityExte **系统能力**：以下各项对应的系统能力均为 SystemCapability.Barrierfree.Accessibility.Core -| 名称 | 描述 | -| -------- | -------- | +| 名称 | 描述 | +| ----------- | --------- | | application | 表示应用窗口类型。 | -| system | 表示系统窗口类型。 | +| system | 表示系统窗口类型。 | ## AccessibilityExtensionContext.setEventTypeFilter @@ -77,14 +77,14 @@ setEventTypeFilter(type: Array): Promise\; **参数：** -| 参数名 | 参数类型 | 必填 | 说明 | -| ----- | ------ | ------ | ------ | -| type | Array<[EventType](js-apis-accessibility.md#EventType)> | 是 | 关注的事件类型。 | +| 参数名 | 参数类型 | 必填 | 说明 | +| ---- | ---------------------------------------- | ---- | -------- | +| type | Array<[EventType](js-apis-accessibility.md#EventType)> | 是 | 关注的事件类型。 | **返回值：** -| 类型 | 说明 | -| -------------------------------- | --------------------------------------- | +| 类型 | 说明 | +| ---------------------- | --------------------- | | Promise<boolean> | Promise对象。返回当前设置是否成功。 | **示例：** @@ -103,14 +103,14 @@ setTargetBundleName(targetNames: Array\): Promise\; **参数：** -| 参数名 | 参数类型 | 必填 | 说明 | -| ----- | ------ | ------ | ------ | -| targetNames | Array<string> | 是 | 关注的目标包名。 | +| 参数名 | 参数类型 | 必填 | 说明 | +| ----------- | ------------------- | ---- | -------- | +| targetNames | Array<string> | 是 | 关注的目标包名。 | **返回值：** -| 类型 | 说明 | -| -------------------------------- | --------------------------------------- | +| 类型 | 说明 | +| ---------------------- | --------------------- | | Promise<boolean> | Promise对象。返回当前设置是否成功。 | **示例：** @@ -129,14 +129,14 @@ getFocusElement(isAccessibilityFocus?: boolean): Promise\; **参数：** -| 参数名 | 参数类型 | 必填 | 说明 | -| ----- | ------ | ------ | ------ | -| isAccessibilityFocus | boolean | 否 | 获取的是否是无障碍焦点元素，默认为否。 | +| 参数名 | 参数类型 | 必填 | 说明 | +| -------------------- | ------- | ---- | ------------------- | +| isAccessibilityFocus | boolean | 否 | 获取的是否是无障碍焦点元素，默认为否。 | **返回值：** -| 类型 | 说明 | -| -------------------------------- | --------------------------------------- | +| 类型 | 说明 | +| ----------------------------------- | ---------------------- | | Promise<AccessibilityElement> | Promise对象。返回当前对应的焦点元素。 | **示例：** @@ -157,14 +157,14 @@ getWindowRootElement(windowId?: number): Promise\; **参数：** -| 参数名 | 参数类型 | 必填 | 说明 | -| ----- | ------ | ------ | ------ | -| windowId | number | 否 | 指定获取根节点元素的窗口，未指定则从当前活跃窗口获取。 | +| 参数名 | 参数类型 | 必填 | 说明 | +| -------- | ------ | ---- | --------------------------- | +| windowId | number | 否 | 指定获取根节点元素的窗口，未指定则从当前活跃窗口获取。 | **返回值：** -| 类型 | 说明 | -| -------------------------------- | --------------------------------------- | +| 类型 | 说明 | +| ----------------------------------- | ----------------------- | | Promise<AccessibilityElement> | Promise对象。返回当前对应的根节点元素。 | **示例：** @@ -185,14 +185,14 @@ getWindows(displayId?: number): Promise>; **参数：** -| 参数名 | 参数类型 | 必填 | 说明 | -| ----- | ------ | ------ | ------ | -| displayId | number | 否 | 指定获取窗口信息的屏幕，未指定则从默认主屏幕获取。 | +| 参数名 | 参数类型 | 必填 | 说明 | +| --------- | ------ | ---- | ------------------------- | +| displayId | number | 否 | 指定获取窗口信息的屏幕，未指定则从默认主屏幕获取。 | **返回值：** -| 类型 | 说明 | -| -------------------------------- | --------------------------------------- | +| 类型 | 说明 | +| ---------------------------------------- | ------------------------ | | Promise<Array<AccessibilityElement>> | Promise对象。返回当前对应的窗口列表信息。 | **示例：** @@ -213,15 +213,15 @@ gestureInject(gesturePath: GesturePath, listener: Callback\): Promise\< **参数：** -| 参数名 | 参数类型 | 必填 | 说明 | -| ----- | ------ | ------ | ------ | -| gesturePath | [GesturePath](js-apis-application-AccessibilityExtensionAbility.md#GesturePath) | 是 | 表示手势的路径信息。 | -| listener | Callback<boolean> | 是 | 表示注入手势执行结果的回调。 | +| 参数名 | 参数类型 | 必填 | 说明 | +| ----------- | ---------------------------------------- | ---- | -------------- | +| gesturePath | [GesturePath](js-apis-application-AccessibilityExtensionAbility.md#GesturePath) | 是 | 表示手势的路径信息。 | +| listener | Callback<boolean> | 是 | 表示注入手势执行结果的回调。 | **返回值：** -| 类型 | 说明 | -| -------------------------------- | --------------------------------------- | +| 类型 | 说明 | +| ---------------------- | ---------------------- | | Promise<boolean> | Promise对象。返回注入手势的调用结果。 | **示例：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-AccessibilityExtensionAbility.md b/zh-cn/application-dev/reference/apis/js-apis-application-AccessibilityExtensionAbility.md index 586b0c7e0b..6944985643 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-AccessibilityExtensionAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-AccessibilityExtensionAbility.md @@ -11,7 +11,7 @@ ## 导入模块 ```ts -import AccessibilityExtensionAbility from './@ohos.application.AccessibilityExtensionAbility' +import AccessibilityExtensionAbility from '@ohos.application.AccessibilityExtensionAbility' ``` ## AccessibilityEvent @@ -22,11 +22,11 @@ import AccessibilityExtensionAbility from './@ohos.application.AccessibilityExte ### 属性 -| 名称 | 参数类型 | 可读 | 可写 | 说明 | -| -------- | -------- | -------- | -------- | -------- | -| eventType | [EventType](js-apis-accessibility.md#EventType) \| [WindowUpdateType](js-apis-accessibility.md#WindowUpdateType) \| [TouchGuideType](touchguidetype) \| [GestureType](gesturetype) \| [PageUpdateType](pageupdatetype) | 是 | 否 | 具体事件类型。 | -| target | AccessibilityElement | 是 | 否 | 发生事件的目标组件。 | -| timeStamp | number | 是 | 否 | 事件时间戳。 | +| 名称 | 参数类型 | 可读 | 可写 | 说明 | +| --------- | ---------------------------------------- | ---- | ---- | ---------- | +| eventType | [EventType](js-apis-accessibility.md#EventType) \| [WindowUpdateType](js-apis-accessibility.md#WindowUpdateType) \| [TouchGuideType](touchguidetype) \| [GestureType](gesturetype) \| [PageUpdateType](pageupdatetype) | 是 | 否 | 具体事件类型。 | +| target | AccessibilityElement | 是 | 否 | 发生事件的目标组件。 | +| timeStamp | number | 是 | 否 | 事件时间戳。 | ## GesturePath @@ -36,10 +36,10 @@ import AccessibilityExtensionAbility from './@ohos.application.AccessibilityExte ### 属性 -| 名称 | 参数类型 | 可读 | 可写 | 说明 | -| -------- | -------- | -------- | -------- | -------- | -| points | Array<[GesturePoint](gesturepoint)> | 是 | 是 | 手势。 | -| durationTime | number | 是 | 是 | 手势总耗时。 | +| 名称 | 参数类型 | 可读 | 可写 | 说明 | +| ------------ | ---------------------------------------- | ---- | ---- | ------ | +| points | Array<[GesturePoint](gesturepoint)> | 是 | 是 | 手势。 | +| durationTime | number | 是 | 是 | 手势总耗时。 | ### 方法 @@ -51,9 +51,9 @@ constructor(durationTime: number) - 参数： - | 参数名 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | durationTime | number | 是 | 手势总耗时。 | + | 参数名 | 参数类型 | 必填 | 说明 | + | ------------ | ------ | ---- | ------ | + | durationTime | number | 是 | 手势总耗时。 | - 示例 @@ -69,10 +69,10 @@ constructor(durationTime: number) ### 属性 -| 名称 | 参数类型 | 可读 | 可写 | 说明 | -| -------- | -------- | -------- | -------- | -------- | -| positionX | number | 是 | 是 | 触摸点X坐标。 | -| positionY | number | 是 | 是 | 触摸点Y坐标。 | +| 名称 | 参数类型 | 可读 | 可写 | 说明 | +| --------- | ------ | ---- | ---- | ------- | +| positionX | number | 是 | 是 | 触摸点X坐标。 | +| positionY | number | 是 | 是 | 触摸点Y坐标。 | ### 方法 @@ -84,10 +84,10 @@ constructor(positionX: number, positionY: number) - 参数： - | 参数名 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | positionX | number | 是 | 触摸点X坐标。 | - | positionY | number | 是 | 触摸点Y坐标。 | + | 参数名 | 参数类型 | 必填 | 说明 | + | --------- | ------ | ---- | ------- | + | positionX | number | 是 | 触摸点X坐标。 | + | positionY | number | 是 | 触摸点Y坐标。 | - 示例 @@ -101,24 +101,24 @@ constructor(positionX: number, positionY: number) **系统能力**：以下各项对应的系统能力均为 SystemCapability.Barrierfree.Accessibility.Core -| 名称 | 描述 | -| -------- | -------- | -| left | 表示向左的手势。 | +| 名称 | 描述 | +| ------------- | ------------ | +| left | 表示向左的手势。 | | leftThenRight | 表示先向左再向右的手势。 | -| leftThenUp | 表示先向左再向上的手势。 | -| leftThenDown | 表示先向左再向下的手势。 | -| right | 表示向右的手势。 | +| leftThenUp | 表示先向左再向上的手势。 | +| leftThenDown | 表示先向左再向下的手势。 | +| right | 表示向右的手势。 | | rightThenLeft | 表示先向右再向左的手势。 | -| rightThenUp | 表示先向右再向上的手势。 | +| rightThenUp | 表示先向右再向上的手势。 | | rightThenDown | 表示先向右再向下的手势。 | -| up | 表示向上的手势。 | -| upThenLeft | 表示先向上再向左的手势。 | -| upThenRight | 表示先向上再向右的手势。 | -| upThenDown | 表示先向上再向下的手势。 | -| down | 表示向下的手势。 | -| downThenLeft | 表示先向下再向左的手势。 | +| up | 表示向上的手势。 | +| upThenLeft | 表示先向上再向左的手势。 | +| upThenRight | 表示先向上再向右的手势。 | +| upThenDown | 表示先向上再向下的手势。 | +| down | 表示向下的手势。 | +| downThenLeft | 表示先向下再向左的手势。 | | downThenRight | 表示先向下再向右的手势。 | -| downThenUp | 表示先向下再向上的手势。 | +| downThenUp | 表示先向下再向上的手势。 | ## PageUpdateType @@ -126,10 +126,10 @@ constructor(positionX: number, positionY: number) **系统能力**：以下各项对应的系统能力均为 SystemCapability.Barrierfree.Accessibility.Core -| 名称 | 描述 | -| -------- | -------- | +| 名称 | 描述 | +| ----------------- | --------- | | pageContentUpdate | 表示页面内容刷新。 | -| pageStateUpdate | 表示页面状态刷新。 | +| pageStateUpdate | 表示页面状态刷新。 | ## TouchGuideType @@ -137,10 +137,10 @@ constructor(positionX: number, positionY: number) **系统能力**：以下各项对应的系统能力均为 SystemCapability.Barrierfree.Accessibility.Core -| 名称 | 描述 | -| -------- | -------- | +| 名称 | 描述 | +| ---------- | ------------ | | touchBegin | 表示触摸浏览时开始触摸。 | -| touchEnd | 表示触摸浏览时结束触摸。 | +| touchEnd | 表示触摸浏览时结束触摸。 | ## AccessibilityExtensionAbility.onConnect @@ -192,9 +192,9 @@ onAccessibilityEvent(event: AccessibilityEvent): void; **参数：** -| 参数名 | 参数类型 | 必填 | 说明 | -| ----- | ------ | ------ | ------ | -| event | [AccessibilityEvent](accessibilityevent) | 是 | 无障碍事件回调函数。无返回值。 | +| 参数名 | 参数类型 | 必填 | 说明 | +| ----- | ---------------------------------------- | ---- | --------------- | +| event | [AccessibilityEvent](accessibilityevent) | 是 | 无障碍事件回调函数。无返回值。 | **示例：** @@ -217,9 +217,9 @@ onKeyEvent(keyEvent: inputEventClient.KeyEvent): boolean; **参数：** -| 参数名 | 参数类型 | 必填 | 说明 | -| ----- | ------ | ------ | ------ | -| keyEvent | [KeyEvent](js-apis-inputeventclient.md#KeyEvent) | 是 | 按键事件回调函数。返回true表示拦截此按键。 | +| 参数名 | 参数类型 | 必填 | 说明 | +| -------- | ---------------------------------------- | ---- | ----------------------- | +| keyEvent | [KeyEvent](js-apis-inputeventclient.md#KeyEvent) | 是 | 按键事件回调函数。返回true表示拦截此按键。 | **示例：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-device-manager.md b/zh-cn/application-dev/reference/apis/js-apis-device-manager.md index adc870047f..cac1ec40cf 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-device-manager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-device-manager.md @@ -32,10 +32,10 @@ createDeviceManager(bundleName: string, callback: AsyncCallback<DeviceManager **系统能力**：SystemCapability.DistributedHardware.DeviceManager - 参数： - | 参数名 | 类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | bundleName | string | 是 | 指示应用程序的包名。 | - | callback | AsyncCallback<[DeviceManager](#devicemanager)> | 是 | DeviceManager实例创建时调用的回调，返回设备管理器对象实例。 | + | 参数名 | 类型 | 必填 | 说明 | + | ---------- | ---------------------------------------- | ---- | ------------------------------------ | + | bundleName | string | 是 | 指示应用程序的包名。 | + | callback | AsyncCallback<[DeviceManager](#devicemanager)> | 是 | DeviceManager实例创建时调用的回调，返回设备管理器对象实例。 | - 示例： ``` @@ -45,7 +45,7 @@ createDeviceManager(bundleName: string, callback: AsyncCallback<DeviceManager return; } console.info("createDeviceManager success"); - this.dmInstance = data; + let dmInstance = data; }); ``` @@ -55,12 +55,12 @@ createDeviceManager(bundleName: string, callback: AsyncCallback<DeviceManager **系统能力**：以下各项对应的系统能力均为SystemCapability.DistributedHardware.DeviceManager -| 名称 | 类型 | 必填 | 描述 | -| -------- | -------- | -------- | -------- | -| deviceId | string | 是 | 设备的唯一标识。 | -| deviceName | string | 是 | 设备名称。 | -| deviceType | [DeviceType](#devicetype) | 是 | 设备类型。 | -| networkId8+ | string | 是 | 设备网络标识。 | +| 名称 | 类型 | 必填 | 描述 | +| ---------------------- | ------------------------- | ---- | -------- | +| deviceId | string | 是 | 设备的唯一标识。 | +| deviceName | string | 是 | 设备名称。 | +| deviceType | [DeviceType](#devicetype) | 是 | 设备类型。 | +| networkId8+ | string | 是 | 设备网络标识。 | ## DeviceType @@ -69,15 +69,15 @@ createDeviceManager(bundleName: string, callback: AsyncCallback<DeviceManager **系统能力**：以下各项对应的系统能力均为SystemCapability.DistributedHardware.DeviceManager -| 名称 | 默认值 | 说明 | -| -------- | -------- | -------- | -| SPEAKER | 0x0A | 智能音箱 | -| PHONE | 0x0E | 手机 | -| TABLET | 0x11 | 平板 | -| WEARABLE | 0x6D | 智能穿戴 | -| TV | 0x9C | 智慧屏 | -| CAR | 0x83 | 车 | -| UNKNOWN_TYPE | 0 | 未知设备 | +| 名称 | 默认值 | 说明 | +| ------------ | ---- | ---- | +| SPEAKER | 0x0A | 智能音箱 | +| PHONE | 0x0E | 手机 | +| TABLET | 0x11 | 平板 | +| WEARABLE | 0x6D | 智能穿戴 | +| TV | 0x9C | 智慧屏 | +| CAR | 0x83 | 车 | +| UNKNOWN_TYPE | 0 | 未知设备 | ## DeviceStateChangeAction @@ -86,12 +86,12 @@ createDeviceManager(bundleName: string, callback: AsyncCallback<DeviceManager **系统能力**：以下各项对应的系统能力均为SystemCapability.DistributedHardware.DeviceManager -| 名称 | 默认值 | 说明 | -| -------- | -------- | -------- | -| ONLINE | 0 | 设备上线。 | -| READY | 1 | 设备就绪，设备信息同步已完成。 | -| OFFLINE | 2 | 设备下线。 | -| CHANGE | 3 | 设备信息更改。 | +| 名称 | 默认值 | 说明 | +| ------- | ---- | --------------- | +| ONLINE | 0 | 设备上线。 | +| READY | 1 | 设备就绪，设备信息同步已完成。 | +| OFFLINE | 2 | 设备下线。 | +| CHANGE | 3 | 设备信息更改。 | ## SubscribeInfo @@ -99,15 +99,15 @@ createDeviceManager(bundleName: string, callback: AsyncCallback<DeviceManager **系统能力**：以下各项对应的系统能力均为SystemCapability.DistributedHardware.DeviceManager -| 名称 | 类型 | 必填 | 描述 | -| -------- | -------- | -------- | -------- | -| subscribeId | number | 是 | 发现标识，用于标识不同的发现周期。 | -| mode | [DiscoverMode ](#discovermode) | 否 | 发现模式。 | -| medium | [ExchangeMedium](#exchangemedium) | 否 | 发现类型。 | -| freq | [ExchangeFreq](#exchangefreq) | 否 | 发现频率。 | -| isSameAccount | boolean | 否 | 是否同账号。 | -| isWakeRemote | boolean | 否 | 是否唤醒设备。 | -| capability | [SubscribeCap](#subscribecap) | 否 | 发现能力。 | +| 名称 | 类型 | 必填 | 描述 | +| ------------- | --------------------------------- | ---- | ----------------- | +| subscribeId | number | 是 | 发现标识，用于标识不同的发现周期。 | +| mode | [DiscoverMode ](#discovermode) | 否 | 发现模式。 | +| medium | [ExchangeMedium](#exchangemedium) | 否 | 发现类型。 | +| freq | [ExchangeFreq](#exchangefreq) | 否 | 发现频率。 | +| isSameAccount | boolean | 否 | 是否同账号。 | +| isWakeRemote | boolean | 否 | 是否唤醒设备。 | +| capability | [SubscribeCap](#subscribecap) | 否 | 发现能力。 | ## DiscoverMode @@ -116,10 +116,10 @@ createDeviceManager(bundleName: string, callback: AsyncCallback<DeviceManager **系统能力**：以下各项对应的系统能力均为SystemCapability.DistributedHardware.DeviceManager -| 名称 | 默认值 | 说明 | -| -------- | -------- | -------- | +| 名称 | 默认值 | 说明 | +| --------------------- | ---- | ----- | | DISCOVER_MODE_PASSIVE | 0x55 | 被动模式。 | -| DISCOVER_MODE_ACTIVE | 0xAA | 主动模式。 | +| DISCOVER_MODE_ACTIVE | 0xAA | 主动模式。 | ## ExchangeMedium @@ -128,12 +128,12 @@ createDeviceManager(bundleName: string, callback: AsyncCallback<DeviceManager **系统能力**：以下各项对应的系统能力均为SystemCapability.DistributedHardware.DeviceManager -| 名称 | 默认值 | 说明 | -| -------- | -------- | -------- | -| AUTO | 0 | 自动发现类型。 | -| BLE | 1 | 蓝牙发现类型。 | -| COAP | 2 | WiFi发现类型。 | -| USB | 3 | USB发现类型。 | +| 名称 | 默认值 | 说明 | +| ---- | ---- | --------- | +| AUTO | 0 | 自动发现类型。 | +| BLE | 1 | 蓝牙发现类型。 | +| COAP | 2 | WiFi发现类型。 | +| USB | 3 | USB发现类型。 | ## ExchangeFreq @@ -141,12 +141,12 @@ createDeviceManager(bundleName: string, callback: AsyncCallback<DeviceManager **系统能力**：以下各项对应的系统能力均为SystemCapability.DistributedHardware.DeviceManager -| 名称 | 默认值 | 说明 | -| -------- | -------- | -------- | -| LOW | 0 | 低频率。 | -| MID | 1 | 中频率。 | -| HIGH | 2 | 高频率。 | -| SUPER_HIGH | 3 | 超高频率。 | +| 名称 | 默认值 | 说明 | +| ---------- | ---- | ----- | +| LOW | 0 | 低频率。 | +| MID | 1 | 中频率。 | +| HIGH | 2 | 高频率。 | +| SUPER_HIGH | 3 | 超高频率。 | ## SubscribeCap @@ -155,10 +155,10 @@ createDeviceManager(bundleName: string, callback: AsyncCallback<DeviceManager **系统能力**：以下各项对应的系统能力均为SystemCapability.DistributedHardware.DeviceManager -| 名称 | 默认值 | 说明 | -| -------- | -------- | -------- | -| SUBSCRIBE_CAPABILITY_DDMP | 0 | DDMP能力，后续会被废弃。 | -| SUBSCRIBE_CAPABILITY_OSD | 1 | OSD能力。 | +| 名称 | 默认值 | 说明 | +| ------------------------- | ---- | -------------- | +| SUBSCRIBE_CAPABILITY_DDMP | 0 | DDMP能力，后续会被废弃。 | +| SUBSCRIBE_CAPABILITY_OSD | 1 | OSD能力。 | ## AuthParam @@ -167,10 +167,10 @@ createDeviceManager(bundleName: string, callback: AsyncCallback<DeviceManager **系统能力**：以下各项对应的系统能力均为SystemCapability.DistributedHardware.DeviceManager -| 名称 | 类型 | 必填 | 描述 | -| -------- | -------- | -------- | -------- | -| authType | number | 是 | 认证类型。 | -| extraInfo | {[key:string] : any} | 否 | 认证参数可扩展字段。 | +| 名称 | 类型 | 必填 | 描述 | +| --------- | -------------------- | ---- | ---------- | +| authType | number | 是 | 认证类型。 | +| extraInfo | {[key:string] : any} | 否 | 认证参数可扩展字段。 | ## AuthInfo @@ -178,11 +178,11 @@ createDeviceManager(bundleName: string, callback: AsyncCallback<DeviceManager **系统能力**：以下各项对应的系统能力均为SystemCapability.DistributedHardware.DeviceManager -| 名称 | 类型 | 必填 | 描述 | -| -------- | -------- | -------- | -------- | -| authType | number | 是 | 认证类型。 | -| token | number | 是 | 认证Token。 | -| extraInfo | {[key:string] : any} | 否 | 认证信息可扩展字段。 | +| 名称 | 类型 | 必填 | 描述 | +| --------- | -------------------- | ---- | ---------- | +| authType | number | 是 | 认证类型。 | +| token | number | 是 | 认证Token。 | +| extraInfo | {[key:string] : any} | 否 | 认证信息可扩展字段。 | ## DeviceManager @@ -213,8 +213,8 @@ getTrustedDeviceListSync(): Array<DeviceInfo> **系统能力**：SystemCapability.DistributedHardware.DeviceManager - 返回值： - | 名称 | 说明 | - | -------- | -------- | + | 名称 | 说明 | + | -------------------------------------- | --------- | | Array<[DeviceInfo](#deviceinfo)> | 返回可信设备列表。 | - 示例： @@ -232,9 +232,9 @@ getTrustedDeviceList(callback:AsyncCallback<Array<DeviceInfo>>): voi **系统能力**：SystemCapability.DistributedHardware.DeviceManager - 参数： - | 名称 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | callback | AsyncCallback<Array<[DeviceInfo](#deviceinfo)>> | 是 | 获取所有可信设备列表的回调，返回设备信息。 | + | 名称 | 参数类型 | 必填 | 说明 | + | -------- | ---------------------------------------- | ---- | --------------------- | + | callback | AsyncCallback<Array<[DeviceInfo](#deviceinfo)>> | 是 | 获取所有可信设备列表的回调，返回设备信息。 | - 示例： ```js @@ -254,8 +254,8 @@ getTrustedDeviceList(): Promise<Array<DeviceInfo>> **系统能力**：SystemCapability.DistributedHardware.DeviceManager - 返回值： - | 类型 | 说明 | - | -------- | -------- | + | 类型 | 说明 | + | ---------------------------------------- | --------------------- | | Promise<Array<[DeviceInfo](#deviceinfo)>> | Promise实例，用于获取异步返回结果。 | - 示例： @@ -276,8 +276,8 @@ getLocalDeviceInfoSync(): [DeviceInfo](#deviceinfo) **系统能力**：SystemCapability.DistributedHardware.DeviceManager - 返回值： - | 名称 | 说明 | - | -------- | -------- | + | 名称 | 说明 | + | -------------------------------------- | --------- | | Array<[DeviceInfo](#deviceinfo)> | 返回本地设备列表。 | - 示例： @@ -295,9 +295,9 @@ getLocalDeviceInfo(callback:AsyncCallback<DeviceInfo>): void **系统能力**：SystemCapability.DistributedHardware.DeviceManager - 参数： - | 名称 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | callback | AsyncCallback<[DeviceInfo](#deviceinfo)> | 是 | 获取本地设备信息。 | + | 名称 | 参数类型 | 必填 | 说明 | + | -------- | ---------------------------------------- | ---- | --------- | + | callback | AsyncCallback<[DeviceInfo](#deviceinfo)> | 是 | 获取本地设备信息。 | - 示例： ```js @@ -317,8 +317,8 @@ getLocalDeviceInfo(): Promise<DeviceInfo> **系统能力**：SystemCapability.DistributedHardware.DeviceManager - 返回值： - | 类型 | 说明 | - | -------- | -------- | + | 类型 | 说明 | + | ---------------------------------------- | --------------------- | | Promise<[DeviceInfo](#deviceinfo)> | Promise实例，用于获取异步返回结果。 | - 示例： @@ -339,9 +339,9 @@ startDeviceDiscovery(subscribeInfo: SubscribeInfo): void **系统能力**：SystemCapability.DistributedHardware.DeviceManager - 参数： - | 名称 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | subscribeInfo | [SubscribeInfo](#subscribeinfo) | 是 | 发现信息。 | + | 名称 | 参数类型 | 必填 | 说明 | + | ------------- | ------------------------------- | ---- | ----- | + | subscribeInfo | [SubscribeInfo](#subscribeinfo) | 是 | 发现信息。 | - 示例： ```js @@ -368,9 +368,9 @@ stopDeviceDiscovery(subscribeId: number): void **系统能力**：SystemCapability.DistributedHardware.DeviceManager - 参数： - | 名称 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | subscribeId | number | 是 | 发现标识。 | + | 名称 | 参数类型 | 必填 | 说明 | + | ----------- | ------ | ---- | ----- | + | subscribeId | number | 是 | 发现标识。 | - 示例： ```js @@ -387,11 +387,11 @@ authenticateDevice(deviceInfo: DeviceInfo, authParam: AuthParam, callback: Async **系统能力**：SystemCapability.DistributedHardware.DeviceManager - 参数： - | 名称 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | deviceInfo | [DeviceInfo](#deviceinfo) | 是 | 设备信息。 | - | authParam | [AuthParam](#authparam) | 是 | 认证参数。 | - | callback | AsyncCallback<{ deviceId: string, pinToken ?: number }> | 是 | 认证结果回调。 | + | 名称 | 参数类型 | 必填 | 说明 | + | ---------- | ---------------------------------------- | ---- | ------- | + | deviceInfo | [DeviceInfo](#deviceinfo) | 是 | 设备信息。 | + | authParam | [AuthParam](#authparam) | 是 | 认证参数。 | + | callback | AsyncCallback<{ deviceId: string, pinToken ?: number }> | 是 | 认证结果回调。 | - 示例： ```js @@ -424,9 +424,9 @@ unAuthenticateDevice(deviceInfo: DeviceInfo): void **系统能力**：SystemCapability.DistributedHardware.DeviceManager - 参数： - | 名称 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | deviceInfo | [DeviceInfo](#deviceinfo) | 是 | 设备信息。 | + | 名称 | 参数类型 | 必填 | 说明 | + | ---------- | ------------------------- | ---- | ----- | + | deviceInfo | [DeviceInfo](#deviceinfo) | 是 | 设备信息。 | - 示例： ```js @@ -443,10 +443,10 @@ verifyAuthInfo(authInfo: AuthInfo, callback: AsyncCallback<{deviceId: string, le **系统能力**：SystemCapability.DistributedHardware.DeviceManager - 参数： - | 名称 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | authInfo | [AuthInfo](#authinfo) | 是 | 认证信息。 | - | authInfo | AsyncCallback<{ deviceId: string, level: number }> | 是 | 验证结果回调。 | + | 名称 | 参数类型 | 必填 | 说明 | + | -------- | ---------------------------------------- | ---- | ------- | + | authInfo | [AuthInfo](#authinfo) | 是 | 认证信息。 | + | authInfo | AsyncCallback<{ deviceId: string, level: number }> | 是 | 验证结果回调。 | - 示例： ```js @@ -474,10 +474,10 @@ on(type: 'deviceStateChange', callback: Callback<{ action: DeviceStateChange **系统能力**：SystemCapability.DistributedHardware.DeviceManager - 参数： - | 名称 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | type | string | 是 | 注册设备状态回调，固定为deviceStateChange。 | - | callback | Callback<{ action: [DeviceStateChangeAction](#devicestatechangeaction), device: [DeviceInfo](#deviceinfo) }> | 是 | 指示要注册的设备状态回调，返回设备状态和设备信息。 | + | 名称 | 参数类型 | 必填 | 说明 | + | -------- | ---------------------------------------- | ---- | ------------------------------ | + | type | string | 是 | 注册设备状态回调，固定为deviceStateChange。 | + | callback | Callback<{ action: [DeviceStateChangeAction](#devicestatechangeaction), device: [DeviceInfo](#deviceinfo) }> | 是 | 指示要注册的设备状态回调，返回设备状态和设备信息。 | - 示例： ```js @@ -497,10 +497,10 @@ off(type: 'deviceStateChange', callback?: Callback<{ action: DeviceStateChang **系统能力**：SystemCapability.DistributedHardware.DeviceManager - 参数： - | 名称 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | type | string | 是 | 根据应用程序的包名取消注册设备状态回调。 | - | callback | Callback<{ action: [DeviceStateChangeAction](#devicestatechangeaction), device: [DeviceInfo](#deviceinfo)  }> | 是 | 指示要取消注册的设备状态回调，返回设备状态和设备信息。 | + | 名称 | 参数类型 | 必填 | 说明 | + | -------- | ---------------------------------------- | ---- | --------------------------- | + | type | string | 是 | 根据应用程序的包名取消注册设备状态回调。 | + | callback | Callback<{ action: [DeviceStateChangeAction](#devicestatechangeaction), device: [DeviceInfo](#deviceinfo)  }> | 是 | 指示要取消注册的设备状态回调，返回设备状态和设备信息。 | - 示例： ```js @@ -520,10 +520,10 @@ on(type: 'deviceFound', callback: Callback<{ subscribeId: number, device: Dev **系统能力**：SystemCapability.DistributedHardware.DeviceManager - 参数： - | 名称 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | type | string | 是 | 注册设备发现回调，以便在发现周边设备时通知应用程序。 | - | callback | Callback<{ subscribeId: number, device: DeviceInfo }> | 是 | 注册设备发现的回调方法。 | + | 名称 | 参数类型 | 必填 | 说明 | + | -------- | ---------------------------------------- | ---- | -------------------------- | + | type | string | 是 | 注册设备发现回调，以便在发现周边设备时通知应用程序。 | + | callback | Callback<{ subscribeId: number, device: DeviceInfo }> | 是 | 注册设备发现的回调方法。 | - 示例： ```js @@ -542,10 +542,10 @@ off(type: 'deviceFound', callback?: Callback<{ subscribeId: number, device: D **系统能力**：SystemCapability.DistributedHardware.DeviceManager - 参数： - | 名称 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | type | string | 是 | 取消注册设备发现回调。 | - | callback | Callback<{ subscribeId: number, device: [DeviceInfo](#deviceinfo) }> | 是 | 指示要取消注册的设备发现回调，返回设备状态和设备信息。 | + | 名称 | 参数类型 | 必填 | 说明 | + | -------- | ---------------------------------------- | ---- | --------------------------- | + | type | string | 是 | 取消注册设备发现回调。 | + | callback | Callback<{ subscribeId: number, device: [DeviceInfo](#deviceinfo) }> | 是 | 指示要取消注册的设备发现回调，返回设备状态和设备信息。 | - 示例： ```js @@ -564,10 +564,10 @@ on(type: 'discoverFail', callback: Callback<{ subscribeId: number, reason: nu **系统能力**：SystemCapability.DistributedHardware.DeviceManager - 参数： - | 名称 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | type | string | 是 | 注册设备发现失败回调，以便在发现周边设备失败时通知应用程序。 | - | callback | Callback<{ subscribeId: number, reason: number }> | 是 | 注册设备发现失败的回调方法。 | + | 名称 | 参数类型 | 必填 | 说明 | + | -------- | ---------------------------------------- | ---- | ------------------------------ | + | type | string | 是 | 注册设备发现失败回调，以便在发现周边设备失败时通知应用程序。 | + | callback | Callback<{ subscribeId: number, reason: number }> | 是 | 注册设备发现失败的回调方法。 | - 示例： ```js @@ -586,10 +586,10 @@ off(type: 'discoverFail', callback?: Callback<{ subscribeId: number, reason: **系统能力**：SystemCapability.DistributedHardware.DeviceManager - 参数： - | 名称 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | type | string | 是 | 取消注册设备发现失败回调。 | - | callback | Callback<{ subscribeId: number, reason: number }> | 是 | 指示要取消注册的设备发现失败回调。 | + | 名称 | 参数类型 | 必填 | 说明 | + | -------- | ---------------------------------------- | ---- | ----------------- | + | type | string | 是 | 取消注册设备发现失败回调。 | + | callback | Callback<{ subscribeId: number, reason: number }> | 是 | 指示要取消注册的设备发现失败回调。 | - 示例： ```js @@ -609,10 +609,10 @@ on(type: 'serviceDie', callback: () => void): void **系统能力**：SystemCapability.DistributedHardware.DeviceManager - 参数： - | 名称 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | type | string | 是 | 注册serviceDie回调，以便在devicemanager服务异常终止时通知应用程序。 | - | callback | () => void | 是 | 注册serviceDie的回调方法。 | + | 名称 | 参数类型 | 必填 | 说明 | + | -------- | ----------------------- | ---- | ---------------------------------------- | + | type | string | 是 | 注册serviceDie回调，以便在devicemanager服务异常终止时通知应用程序。 | + | callback | () => void | 是 | 注册serviceDie的回调方法。 | - 示例： ```js @@ -632,10 +632,10 @@ off(type: 'serviceDie', callback?: () => void): void **系统能力**：SystemCapability.DistributedHardware.DeviceManager - 参数： - | 名称 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | type | string | 是 | 取消注册serviceDie回调，以便在devicemanager服务异常终止时通知应用程序。 | - | callback | () => void | 否 | 取消注册serviceDie的回调方法。 | + | 名称 | 参数类型 | 必填 | 说明 | + | -------- | ----------------------- | ---- | ---------------------------------------- | + | type | string | 是 | 取消注册serviceDie回调，以便在devicemanager服务异常终止时通知应用程序。 | + | callback | () => void | 否 | 取消注册serviceDie的回调方法。 | - 示例： ```js -- GitLab