输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心
全部文档
指南
API
开放能力API
高级筛选
API version全部版本
设备全部
元服务API集不筛选
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
开发与测试开放能力API系统网络Accessory Kit（配件接入服务）ArkTS APIaccessoryAccessManager（配件接入管理）

accessoryAccessManager（配件接入管理）

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+
更新时间: 2026-08-29 09:41
本文导读
展开章节

配件接入管理模块面向华为生态合作配件设备及其生态应用提供关联唤醒、系统服务关联、按需调度和安全授信管理等能力。

起始版本： 26.0.0

导入模块

收起
自动换行
深色代码主题
复制
  1. import { accessoryAccessManager } from '@kit.AccessoryKit';

DiscoveryType

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

枚举类型，配件设备被主机设备发现和识别的通信类型。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

起始版本： 26.0.0

展开
名称 值 说明
PARTNER_BLE_CONNECT 0 使用开发者提供的BLE MAC地址来创建BLE GATT关系。

ServiceName

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

枚举类型，设备关联的服务名称。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

起始版本： 26.0.0

展开
名称 值 说明
PARTNER_APP_ACCESSORY_COLLABORATION 'P_AppAccessoryCollaboration' 该应用和配件之间会相互交互，唤醒彼此并传输数据。
PARTNER_SHARE_SERVICE 'P_ShareService' 接收从配件共享的文件。
PARTNER_DISTRIBUTED_CAMERA_SERVICE 'P_DCameraService' 将该配件用作分布式摄像头。

WakeupType

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

枚举类型，唤醒应用的方式。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

起始版本： 26.0.0

展开
名称 值 说明
START_ABILITY_BY_CALL 0 通过startAbilityByCall唤醒应用。

StringResourceInfo

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

被唤醒应用信息的简要说明。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

起始版本： 26.0.0

展开
名称 类型 只读 可选 说明
bundleName string 否 是 包名。
moduleName string 否 否 模块名。
stringResourceId number 否 否 资源编号。

WakeupInfo

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

唤醒类型以及被唤醒应用的信息。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

起始版本： 26.0.0

展开
名称 类型 只读 可选 说明
wakeupType WakeupType 否 否 唤醒类型。
bundleName string 否 否 包名。
abilityName string 否 否 能力名称。
briefDesc StringResourceInfo 否 否 简要说明，内容包含bundleName，moduleName和stringResourceId，用于获取对应用的简要描述。

ServiceInfo

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

关联的服务类型和对应的服务参数。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

起始版本： 26.0.0

展开
名称 类型 只读 可选 说明
serviceName ServiceName 否 否 设备关联的服务名称。
parameters Record<string, Object> 否 是 关联服务的相关参数。

PickerItemInfo

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

配件的信息及配件关联的服务。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

起始版本： 26.0.0

展开
名称 类型 只读 可选 说明
discoveryType DiscoveryType 否 否 配件发现类型。
hasScreen boolean 否 是 该字段表示设备是否具有用于显示PIN码等内容的屏幕。true代表有屏设备，false代表无屏设备。默认值为false。
bleAddress string 否 是 BLE地址。
bleMtuSize number 否 是 最大传输单元（MTU）大小。
productId string 否 是 产品编号。
subProductId string 否 是 子产品编号。
displayName string 否 否 弹窗显示的设备名称。
displayImage image.PixelMap 否 否 弹窗显示的设备图片。
requestAttachServiceInfo Array<ServiceInfo> 否 否 配件认证通过后，关联的业务信息。

AccessoryInfo

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

配件信息。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

起始版本： 26.0.0

展开
名称 类型 只读 可选 说明
accessoryId string 否 是 配件编号。
bleAddress string 否 是 BLE地址。
displayName string 否 否 配件展示的名称。
productId string 否 是 产品编号。

AccessEvent

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

枚举类型，配件设备接入事件。触发参考showAccessPicker接口事件回调数据结构说明。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

起始版本： 26.0.0

展开
名称 值 说明
PICKER_PRESENT 0 选择器出现事件。
PICKER_DISMISS 1 选择器消失事件。
PICKER_END_SUCC 2 选择器成功结束事件。
PICKER_END_FAIL 3 选择器失败结束事件。
SERVICE_ATTACHING 300 服务挂载事件。
SERVICE_ATTACH_SUCC 301 服务挂载成功事件。
SERVICE_ATTACH_FAIL 302 服务挂载失败事件。

AttachServiceInfo

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

挂载配件信息和服务信息。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

起始版本： 26.0.0

展开
名称 类型 只读 可选 说明
attachId number 否 否 挂载服务的编号。
accessoryInfo AccessoryInfo 否 否 配件信息。
serviceInfo ServiceInfo 否 否 服务信息。

AccessEventInfo

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

配件接入事件信息。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

起始版本： 26.0.0

展开
名称 类型 只读 可选 说明
accessEvent AccessEvent 否 否 配件设备接入事件，事件触发流程参考showAccessPicker接口事件回调数据结构说明。
attachServiceInfo AttachServiceInfo 否 是 挂载服务信息。
errorCode number 否 是

接入事件错误码。

0：正常结果；

10000：用户取消，正常流程下，点击X按钮；

10001：超时；

10002：鉴权失败，需检查productId是否正确；

10003：弹窗异常；

10004：发起授信异常；

10005：授信失败；

10006：服务挂载失败。
errorDesc string 否 是 接入事件错误描述。

DetachServiceEvent

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

枚举类型，移除配件服务状态。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

起始版本： 26.0.0

展开
名称 值 说明
SERVICE_DETACH_SUCC 0 移除服务成功。
SERVICE_DETACH_FAIL 1 移除服务失败。

AccessManager

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

配件接入管理器。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

起始版本： 26.0.0

showAccessPicker

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

showAccessPicker(items: Array<PickerItemInfo>, callback: Callback<AccessEventInfo>): number

接入配件设备信息及其关联的服务信息。使用Callback异步回调。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

需要权限： 如使用该接口需申请权限ohos.permission.ALLOW_ACCESSORY_ACCESS，该能力受限开放。权限申请方式请参考申请受限权限。

起始版本： 26.0.0

参数：

展开
参数名 类型 必填 说明
items Array<PickerItemInfo> 是 接入的选择项信息数组，当前支持数量为1，传入多个时默认取第一个。
callback Callback<AccessEventInfo> 是 回调函数，返回配件接入事件信息对象。回调结果参考showAccessPicker接口事件回调数据结构说明。

返回值：

展开
类型 说明
number 操作结果：0成功，非0失败。

错误码：

以下错误码的详细介绍请参见通用错误码。

展开
错误码ID 错误信息
201 The permissions check failed.

示例：

收起
自动换行
深色代码主题
复制
  1. import { accessoryAccessManager } from '@kit.AccessoryKit';
  2. import { hilog } from '@kit.PerformanceAnalysisKit';
  3. import { image } from '@kit.ImageKit';
  4. 

  5. const TAG = 'Demo';
  6. 

  7. let briefDesc: accessoryAccessManager.StringResourceInfo = {
  8.   'bundleName': 'com.huawei.accessoryDemo',
  9.   'moduleName': 'entry',
  10.   'stringResourceId': $r('app.string.EntryAbility_desc').id,
  11. }
  12. let wakeupInfo: accessoryAccessManager.WakeupInfo = {
  13.   'wakeupType': accessoryAccessManager.WakeupType.START_ABILITY_BY_CALL,
  14.   'bundleName': 'com.huawei.accessoryDemo',
  15.   'abilityName': 'EntryAbility',
  16.   'briefDesc': briefDesc
  17. }
  18. 

  19. let shareBriefDesc: accessoryAccessManager.StringResourceInfo = {
  20.   'bundleName': 'com.huawei.accessoryDemo',
  21.   'moduleName': 'entry',
  22.   'stringResourceId': $r('app.string.EntryAbility_desc').id,
  23. }
  24. 

  25. let shareWakeupInfo: accessoryAccessManager.WakeupInfo = {
  26.   'wakeupType': accessoryAccessManager.WakeupType.START_ABILITY_BY_CALL,
  27.   'bundleName': 'com.huawei.accessoryDemo',
  28.   'abilityName': 'EntryAbility',
  29.   'briefDesc': shareBriefDesc
  30. }
  31. 

  32. let serviceInfo: Array<accessoryAccessManager.ServiceInfo> = [
  33.   {
  34.     serviceName: accessoryAccessManager.ServiceName.PARTNER_APP_ACCESSORY_COLLABORATION,
  35.     parameters: {
  36.       'serviceName': wakeupInfo
  37.     }
  38.   },
  39.   {
  40.     serviceName: accessoryAccessManager.ServiceName.PARTNER_SHARE_SERVICE,
  41.     parameters: {
  42.       'bundleName': 'com.huawei.accessoryDemo',
  43.     }
  44.   }
  45. ];
  46. 

  47. // 此处创建了一张空图，开发时可自行换成所需图片
  48. const color: ArrayBuffer = new ArrayBuffer(96);
  49. let bufferArr: Uint8Array = new Uint8Array(color);
  50. for (let i = 0; i < bufferArr.length; i++) {
  51.   bufferArr[i] = 0x80;
  52. }
  53. let opts: image.InitializationOptions = {
  54.   editable: true,
  55.   pixelFormat: image.PixelMapFormat.BGRA_8888,
  56.   size: { height: 4, width: 6 },
  57.   alphaType: image.AlphaType.UNPREMUL
  58. }
  59. let pixelMap: image.PixelMap | undefined = undefined;
  60. image.createPixelMap(color, opts).then((srcPixelMap: image.PixelMap) => {
  61.   pixelMap = srcPixelMap;
  62. })
  63. 

  64. let items: Array<accessoryAccessManager.PickerItemInfo> = [
  65.   {
  66.     discoveryType: accessoryAccessManager.DiscoveryType.PARTNER_BLE_CONNECT,
  67.     hasScreen: true,
  68.     bleAddress: 'XX:XX:XX:XX:XX:XX',
  69.     bleMtuSize: 1,
  70.     productId: 'XXXXX',
  71.     subProductId: '',
  72.     displayName: 'xxxx',
  73.     displayImage: pixelMap,
  74.     requestAttachServiceInfo: serviceInfo
  75.   },
  76.   {
  77.     discoveryType: accessoryAccessManager.DiscoveryType.PARTNER_BLE_CONNECT,
  78.     hasScreen: true,
  79.     bleAddress: 'XX:XX:XX:XX:XX:XX',
  80.     bleMtuSize: 1,
  81.     productId: 'XXXXX',
  82.     subProductId: '',
  83.     displayName: 'xxxx',
  84.     displayImage: pixelMap,
  85.     requestAttachServiceInfo: serviceInfo
  86.   }
  87. ];
  88. let accessoryManager: accessoryAccessManager.AccessManager = new accessoryAccessManager.AccessManager();
  89. let result: number = accessoryManager.showAccessPicker(items, (event: accessoryAccessManager.AccessEventInfo) => {
  90.   if (!event) {
  91.     hilog.error(0x0000, TAG, `showAccessPicker failed`);
  92.     return;
  93.   }
  94.   hilog.info(0x0000, TAG, `showAccessPicker callback result: ${event.accessEvent}`);
  95. });
  96. hilog.info(0x0000, TAG, `showAccessPicker result: ${result}`);

modifyDisplayName

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

modifyDisplayName(accessoryId: string, displayName: string): number

重命名配件，用于修改配件设备的展示名称。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

需要权限： 如使用该接口需申请权限ohos.permission.ALLOW_ACCESSORY_ACCESS，该能力受限开放。权限申请方式请参考申请受限权限。

起始版本： 26.0.0

参数：

展开
参数名 类型 必填 说明
accessoryId string 是 设备编号。
displayName string 是 展示名称。

返回值：

展开
类型 说明
number 重命名结果：0成功，非0失败。

错误码：

以下错误码的详细介绍请参见通用错误码。

展开
错误码ID 错误信息
201 The permissions check failed.

示例：

收起
自动换行
深色代码主题
复制
  1. import { accessoryAccessManager } from '@kit.AccessoryKit';
  2. import { hilog } from '@kit.PerformanceAnalysisKit';
  3. 

  4. const TAG = 'Demo';
  5. 

  6. let deviceId = 'deviceIdTest';
  7. let deviceName = 'deviceNameTest';
  8. let accessoryManager: accessoryAccessManager.AccessManager = new accessoryAccessManager.AccessManager();
  9. let result: number = accessoryManager.modifyDisplayName(deviceId, deviceName);
  10. hilog.info(0x0000, TAG, `modifyDisplayName code: ${result}`);

queryAttachedService

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

queryAttachedService(): Array<AttachServiceInfo>

查询已经关联的配件和服务信息。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

需要权限： 如使用该接口需申请权限ohos.permission.ALLOW_ACCESSORY_ACCESS，该能力受限开放。权限申请方式请参考申请受限权限。

起始版本： 26.0.0

返回值：

展开
类型 说明
Array<AttachServiceInfo> 已挂载成功的服务信息数组。

错误码：

以下错误码的详细介绍请参见通用错误码。

展开
错误码ID 错误信息
201 The permissions check failed.

示例：

收起
自动换行
深色代码主题
复制
  1. import { accessoryAccessManager } from '@kit.AccessoryKit';
  2. 

  3. let accessoryManager: accessoryAccessManager.AccessManager = new accessoryAccessManager.AccessManager();
  4. let resultArr: Array<accessoryAccessManager.AttachServiceInfo> = accessoryManager.queryAttachedService();

detachService

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

detachService(attachId: number, callback: Callback<DetachServiceEvent>): number

移除某个已关联的配件或配件关联的服务信息。使用Callback异步回调。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

需要权限： 如使用该接口需申请权限ohos.permission.ALLOW_ACCESSORY_ACCESS，该能力受限开放。权限申请方式请参考申请受限权限。

起始版本： 26.0.0

参数：

展开
参数名 类型 必填 说明
attachId number 是 挂载编号。
callback Callback<DetachServiceEvent> 是 回调函数，返回移除配件服务状态。

返回值：

展开
类型 说明
number 操作结果：0成功，非0失败。

错误码：

以下错误码的详细介绍请参见通用错误码。

展开
错误码ID 错误信息
201 The permissions check failed.

示例：

收起
自动换行
深色代码主题
复制
  1. import { accessoryAccessManager } from '@kit.AccessoryKit';
  2. import { hilog } from '@kit.PerformanceAnalysisKit';
  3. 

  4. const TAG = 'Demo';
  5. 

  6. let accessoryManager: accessoryAccessManager.AccessManager = new accessoryAccessManager.AccessManager();
  7. let attachId = 1;
  8. let result: number = accessoryManager.detachService(attachId, (event: accessoryAccessManager.DetachServiceEvent) => {
  9.   if (!event) {
  10.     hilog.error(0x0000, TAG, `detachService failed`);
  11.     return;
  12.   }
  13.   hilog.info(0x0000, TAG, `detachService event: ${event}`);
  14. });
  15. hilog.info(0x0000, TAG, `detachService result: ${result}`);

ChannelType

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

枚举类型，连接的通道类型。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

起始版本： 26.0.0

展开
名称 值 说明
PARTNER_WIFI_CHANNEL 1 Wi-Fi通道类型。

ChannelEvent

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

枚举类型，连接的通道状态。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

起始版本： 26.0.0

展开
名称 值 说明
CONNECTING 0 连接中。
CONNECTED 1 已连接。
CONNECT_FAIL 2 连接失败。
DISCONNECTED 3 已断开连接。

ChannelEventInfo

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

连接的通道信息。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

起始版本： 26.0.0

展开
名称 类型 只读 可选 说明
channelEvent ChannelEvent 否 否 通道事件。
attachId number 否 否 挂载编号。
channelType ChannelType 否 否 通道类型。
ip string 否 是 IP地址。
errorCode number 否 是 接入事件错误码。
reason string 否 是 描述发生故障时错误的原因。

ConnectRequestInfo

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

连接请求的信息。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

起始版本： 26.0.0

展开
名称 类型 只读 可选 说明
attachId number 否 否 挂载编号。
channelType ChannelType 否 否 通道类型。
serviceDesc StringResourceInfo 否 否 服务描述。

ConnectManager

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

连接管理器。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

起始版本： 26.0.0

registerConnectListener

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

registerConnectListener(attachId: number, stateCallback: Callback<ChannelEventInfo>): number

注册一个连接事件监听器，将回调通道的建连和断连的状态。使用Callback异步回调。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

需要权限： 如使用该接口需申请权限ohos.permission.ALLOW_ACCESSORY_ACCESS，该能力受限开放。权限申请方式请参考申请受限权限。

起始版本： 26.0.0

参数：

展开
参数名 类型 必填 说明
attachId number 是 挂载编号。
stateCallback Callback<ChannelEventInfo> 是 回调函数，返回连接通道信息对象。

返回值：

展开
类型 说明
number 注册监听器结果：0成功，非0失败。

错误码：

以下错误码的详细介绍请参见通用错误码。

展开
错误码ID 错误信息
201 The permissions check failed.

示例：

收起
自动换行
深色代码主题
复制
  1. import { accessoryAccessManager } from '@kit.AccessoryKit';
  2. import { hilog } from '@kit.PerformanceAnalysisKit';
  3. 

  4. const TAG = 'Demo';
  5. 

  6. let attachId = 0;
  7. let connectManager: accessoryAccessManager.ConnectManager = new accessoryAccessManager.ConnectManager();
  8. let result : number = connectManager.registerConnectListener(attachId, (event: accessoryAccessManager.ChannelEventInfo) => {
  9.   hilog.info(0x0000, TAG, `registerConnectListener event result: ${JSON.stringify(event)}`);
  10.   if (!event) {
  11.     hilog.error(0x0000, TAG, `registerConnectListener callback event undefined`);
  12.     return;
  13.   }
  14.   if ((event.channelEvent as accessoryAccessManager.ChannelEvent) ==
  15.     accessoryAccessManager.ChannelEvent.CONNECTING) {
  16.     attachId = event.attachId;
  17.   }
  18.   if ((event.channelEvent as accessoryAccessManager.ChannelEvent) ==
  19.     accessoryAccessManager.ChannelEvent.CONNECTED) {
  20.     attachId = event.attachId;
  21.   }
  22. });
  23. hilog.info(0x0000, TAG, `registerConnectListener code: ${result}`);

unregisterConnectListener

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

unregisterConnectListener(attachId: number): number

取消注册连接事件监听器，将停止接收通道连接状态的通知。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

需要权限： 如使用该接口需申请权限ohos.permission.ALLOW_ACCESSORY_ACCESS，该能力受限开放。权限申请方式请参考申请受限权限。

起始版本： 26.0.0

参数：

展开
参数名 类型 必填 说明
attachId number 是 挂载编号。

返回值：

展开
类型 说明
number 取消注册监听器结果：0成功，非0失败。

错误码：

以下错误码的详细介绍请参见通用错误码。

展开
错误码ID 错误信息
201 The permissions check failed.

示例：

收起
自动换行
深色代码主题
复制
  1. import { accessoryAccessManager } from '@kit.AccessoryKit';
  2. import { hilog } from '@kit.PerformanceAnalysisKit';
  3. 

  4. const TAG = 'Demo';
  5. 

  6. let attachId = 1;
  7. let connectManager: accessoryAccessManager.ConnectManager = new accessoryAccessManager.ConnectManager();
  8. let result: number = connectManager.unregisterConnectListener(attachId);
  9. hilog.info(0x0000, TAG, `unregisterConnectListener result: ${JSON.stringify(result)}`);

connect

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

connect(connectRequestInfo: ConnectRequestInfo): number

建立与配件的连接，通过registerConnectListener注册的回调通知连接状态。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

需要权限： 如使用该接口需申请权限ohos.permission.ALLOW_ACCESSORY_ACCESS，该能力受限开放。权限申请方式请参考申请受限权限。

起始版本： 26.0.0

参数：

展开
参数名 类型 必填 说明
connectRequestInfo ConnectRequestInfo 是 连接请求信息。

返回值：

展开
类型 说明
number 建立与配件的连接结果：0成功，非0失败。

错误码：

以下错误码的详细介绍请参见通用错误码。

展开
错误码ID 错误信息
201 The permissions check failed.

示例：

收起
自动换行
深色代码主题
复制
  1. import { accessoryAccessManager } from '@kit.AccessoryKit';
  2. import { hilog } from '@kit.PerformanceAnalysisKit';
  3. 

  4. const TAG = 'Demo';
  5. 

  6. let connectAttachId = 1;
  7. let connectManager: accessoryAccessManager.ConnectManager = new accessoryAccessManager.ConnectManager();
  8. let shareDesc: accessoryAccessManager.StringResourceInfo = {
  9.   bundleName: "com.huawei.accessoryDemo",
  10.   moduleName: "entry",
  11.   stringResourceId: $r('app.string.EntryAbility_desc').id
  12. };
  13. let info: accessoryAccessManager.ConnectRequestInfo =
  14.   {
  15.     attachId: connectAttachId,
  16.     channelType: accessoryAccessManager.ChannelType.PARTNER_WIFI_CHANNEL,
  17.     serviceDesc: shareDesc
  18.   };
  19. let result: number = connectManager.connect(info);
  20. hilog.info(0x0000, TAG, `connect result: ${JSON.stringify(result)}`);

disconnect

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+

disconnect(attachId: number): number

断开与配件的连接，通过registerConnectListener注册的回调通知断连状态。

系统能力： SystemCapability.Collaboration.Accessory.AccessManager

模型约束： 此模块的接口仅可在Stage模型下使用。

需要权限： 如使用该接口需申请权限ohos.permission.ALLOW_ACCESSORY_ACCESS，该能力受限开放。权限申请方式请参考申请受限权限。

起始版本： 26.0.0

参数：

展开
参数名 类型 必填 说明
attachId number 是 挂载编号。

返回值：

展开
类型 说明
number 断开与配件的连接结果：0成功，非0失败。

错误码：

以下错误码的详细介绍请参见通用错误码。

展开
错误码ID 错误信息
201 The permissions check failed.

示例：

收起
自动换行
深色代码主题
复制
  1. import { accessoryAccessManager } from '@kit.AccessoryKit';
  2. import { hilog } from '@kit.PerformanceAnalysisKit';
  3. 

  4. const TAG = 'Demo';
  5. 

  6. let attachId = 1;
  7. let connectManager: accessoryAccessManager.ConnectManager = new accessoryAccessManager.ConnectManager();
  8. let result: number = connectManager.disconnect(attachId);
  9. hilog.info(0x0000, TAG, `disconnect result: ${JSON.stringify(result)}`);
ArkTS API
Connectivity Kit（短距通信服务）
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 开发与测试 开放能力API 中进行搜索
请输入您想要搜索的关键词