鸿蒙5.0开发进阶：@ohos.continuation.continuationManager (continuationManager)

最新推荐文章于 2025-11-25 07:46:32 发布
原创 最新推荐文章于 2025-11-25 07:46:32 发布 · 320 阅读 · 7 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#harmonyos #华为 #android #前端 #鸿蒙系统 #ArkUI #UI框架

往期鸿蒙全套实战文章必看：（文中附带全栈鸿蒙学习资料）

@ohos.continuation.continuationManager (continuationManager)

continuationManager模块提供了流转/协同入口管理服务能力，包括连接/取消流转管理服务，注册/解注册设备连接变化监听，拉起设备选择模块，更新连接状态。

说明

本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import { continuationManager } from '@kit.AbilityKit';

continuationManager.register(deprecated)

register(callback: AsyncCallback<number>): void

注册流转管理服务，并获取对应的注册token，无过滤条件，使用AsyncCallback方式作为异步方法。

说明

从API version 9开始不再维护，建议使用registerContinuation替代。

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
callbackAsyncCallback<number>是AsyncCallback形式返回流转管理服务连接后生成的token。

示例：

import { continuationManager } from '@kit.AbilityKit';

let token: number = -1;
continuationManager.register((err, data) => {
  if (err.code != 0) {
    console.error('register failed, cause: ' + JSON.stringify(err));
    return;
  }
  console.info('register finished, ' + JSON.stringify(data));
  token = data;
});

continuationManager.register(deprecated)

register(options: ContinuationExtraParams, callback: AsyncCallback<number>): void

连接流转管理服务，并获取对应的注册token，使用AsyncCallback方式作为异步方法。

说明

从API version 9开始不再维护，建议使用registerContinuation替代。

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
optionsContinuationExtraParams是过滤可选择设备列表的额外参数。
callbackAsyncCallback<number>是AsyncCallback形式返回流转管理服务连接后生成的token。

示例：

import { continuationManager } from '@kit.AbilityKit';

let token: number = -1;
continuationManager.register(
  {
    deviceType: ["00E"]
  },
  (err, data) => {
    if (err.code != 0) {
      console.error('register failed, cause: ' + JSON.stringify(err));
      return;
    }
    console.info('register finished, ' + JSON.stringify(data));
    token = data;
});

continuationManager.register(deprecated)

register(options?: ContinuationExtraParams): Promise<number>

连接流转管理服务，并获取对应的注册token，使用Promise方式作为异步方法。

说明

从API version 9开始不再维护，建议使用registerContinuation替代。

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
optionsContinuationExtraParams否过滤可选择设备列表的额外参数，该参数可缺省

返回值：

类型说明
Promise<number>Promise形式返回流转管理服务连接后生成的token。

示例：

import { continuationManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let token: number = -1;
continuationManager.register(
  { deviceType: ["00E"] }).then((data) => {
    console.info('register finished, ' + JSON.stringify(data));
    token = data;
  }).catch((err: BusinessError) => {
    console.error('register failed, cause: ' + JSON.stringify(err));
});

continuationManager.registerContinuation9+

registerContinuation(callback: AsyncCallback<number>): void

注册流转管理服务，并获取对应的注册token，无过滤条件，使用AsyncCallback方式作为异步方法。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
callbackAsyncCallback<number>是AsyncCallback形式返回流转管理服务连接后生成的token。

错误码：

以下错误码的详细介绍。

错误码ID错误信息
201Permission denied.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.
16600001The system ability works abnormally.
16600003The number of token registration times has reached the upper limit.

示例：

import { continuationManager } from '@kit.AbilityKit';

let token: number = -1;
try {
continuationManager.registerContinuation((err, data) => {
if (err.code != 0) {
console.error('registerContinuation failed, cause: ' + JSON.stringify(err));
return;
}
console.info('registerContinuation finished, ' + JSON.stringify(data));
token = data;
});
} catch (err) {
console.error('registerContinuation failed, cause: ' + JSON.stringify(err));
}

continuationManager.registerContinuation9+

registerContinuation(options: ContinuationExtraParams, callback: AsyncCallback<number>): void

连接流转管理服务，并获取对应的注册token，使用AsyncCallback方式作为异步方法。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
optionsContinuationExtraParams是过滤可选择设备列表的额外参数。
callbackAsyncCallback<number>是AsyncCallback形式返回流转管理服务连接后生成的token。

错误码：

以下错误码的详细介绍。

错误码ID错误信息
201Permission denied.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.
16600001The system ability works abnormally.
16600003The number of token registration times has reached the upper limit.

示例：

import { continuationManager } from '@kit.AbilityKit';

let token: number = -1;
try {
continuationManager.registerContinuation(
{
deviceType: ["00E"]
},
(err, data) => {
if (err.code != 0) {
console.error('registerContinuation failed, cause: ' + JSON.stringify(err));
return;
}
console.info('registerContinuation finished, ' + JSON.stringify(data));
token = data;
});
} catch (err) {
console.error('registerContinuation failed, cause: ' + JSON.stringify(err));
}

continuationManager.registerContinuation9+

registerContinuation(options?: ContinuationExtraParams): Promise<number>

连接流转管理服务，并获取对应的注册token，使用Promise方式作为异步方法。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
optionsContinuationExtraParams否过滤可选择设备列表的额外参数，该参数可缺省

返回值：

类型说明
Promise<number>Promise形式返回流转管理服务连接后生成的token。

错误码：

以下错误码的详细介绍。

错误码ID错误信息
201Permission denied.
401Parameter error. Possible causes: 1. Incorrect parameter types; 2. Parameter verification failed.
16600001The system ability works abnormally.
16600003The number of token registration times has reached the upper limit.

示例：

import { continuationManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let token: number = -1;
try {
continuationManager.registerContinuation(
{
deviceType: ["00E"]
}).then((data) => {
console.info('registerContinuation finished, ' + JSON.stringify(data));
token = data;
}).catch((err: BusinessError) => {
console.error('registerContinuation failed, cause: ' + JSON.stringify(err));
});
} catch (err) {
console.error('registerContinuation failed, cause: ' + JSON.stringify(err));
}

continuationManager.on('deviceConnect')(deprecated)

on(type: 'deviceConnect', callback: Callback<ContinuationResult>): void

异步方法，监听设备连接状态，使用Callback形式返回连接的设备信息。

说明

从API version 9开始不再维护，建议使用on替代。

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
typestring是监听的事件类型，固定值"deviceConnect"。
callbackCallback<ContinuationResult>是当用户从设备选择模块中选择设备时调用，返回设备ID、设备类型和设备名称供开发者使用。

示例：

import { continuationManager } from '@kit.AbilityKit';

continuationManager.on("deviceConnect", (data) => {
  console.info('onDeviceConnect deviceId: ' + JSON.stringify(data.id));
  console.info('onDeviceConnect deviceType: ' + JSON.stringify(data.type));
  console.info('onDeviceConnect deviceName: ' + JSON.stringify(data.name));
});

continuationManager.on('deviceDisconnect')(deprecated)

on(type: 'deviceDisconnect', callback: Callback<string>): void

异步方法，监听设备断开状态，使用Callback形式返回断开的设备信息。

说明

从API version 9开始不再维护，建议使用on替代。

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
typestring是监听的事件类型，固定值"deviceDisconnect"。
callbackCallback<string>是当用户从设备选择模块中断开设备时调用，返回设备ID供开发者使用。

示例：

import { continuationManager } from '@kit.AbilityKit';

continuationManager.on("deviceDisconnect", (data) => {
console.info('onDeviceDisconnect deviceId: ' + JSON.stringify(data));
});

continuationManager.off('deviceConnect')(deprecated)

off(type: 'deviceConnect', callback?: Callback<ContinuationResult>): void

异步方法，取消监听设备连接状态，使用Callback形式返回连接的设备信息。

说明

从API version 9开始不再维护，建议使用off替代。

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
typestring是取消监听的事件类型，固定值"deviceConnect"。
callbackCallback<ContinuationResult>否当用户从设备选择模块中选择设备时调用，返回设备ID、设备类型和设备名称供开发者使用。

示例：

import { continuationManager } from '@kit.AbilityKit';

continuationManager.off("deviceConnect", (data) => {
console.info('onDeviceConnect deviceId: ' + JSON.stringify(data.id));
console.info('onDeviceConnect deviceType: ' + JSON.stringify(data.type));
console.info('onDeviceConnect deviceName: ' + JSON.stringify(data.name));
});

continuationManager.off('deviceDisconnect')(deprecated)

off(type: 'deviceDisconnect', callback?: Callback<string>): void

异步方法，取消监听设备断开状态，使用Callback形式返回连接的设备信息。

说明

从API version 9开始不再维护，建议使用off替代。

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
typestring是取消监听的事件类型，固定值"deviceDisconnect"。
callbackCallback<string>否当用户从设备选择模块中断开设备时调用，返回设备ID供开发者使用。

示例：

import { continuationManager } from '@kit.AbilityKit';

continuationManager.off("deviceDisconnect", (data) => {
  console.info('onDeviceDisconnect deviceId: ' + JSON.stringify(data));
});

continuationManager.on('deviceSelected')9+

on(type: 'deviceSelected', token: number, callback: Callback<Array<ContinuationResult>>): void

异步方法，监听设备连接状态，使用Callback形式返回连接的设备信息。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
typestring是监听的事件类型，固定值"deviceSelected"。
tokennumber是注册后的token。
callbackCallback<Array<ContinuationResult>>是当用户从设备选择模块中选择设备时调用，返回设备ID、设备类型和设备名称供开发者使用。

错误码：

以下错误码的详细介绍。

错误码ID错误信息
201Permission denied.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.
16600004The specified callback has been registered.

示例：

import { continuationManager } from '@kit.AbilityKit';

let token: number = 1;
try {
continuationManager.on("deviceSelected", token, (data) => {
console.info('onDeviceSelected 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));
}
});
} catch (err) {
console.error('on failed, cause: ' + JSON.stringify(err));
}

continuationManager.on('deviceUnselected')9+

on(type: 'deviceUnselected', token: number, callback: Callback<Array<ContinuationResult>>): void

异步方法，监听设备断开状态，使用Callback形式返回断开的设备信息。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
typestring是监听的事件类型，固定值"deviceUnselected"。
tokennumber是注册后的token。
callbackCallback<Array<ContinuationResult>>是当用户从设备选择模块中断开设备时调用，返回设备ID、设备类型和设备名称供开发者使用。

错误码：

以下错误码的详细介绍。

错误码ID错误信息
201Permission denied.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.
16600004The specified callback has been registered.

示例：

import { continuationManager } from '@kit.AbilityKit';

let token: number = 1;
try {
continuationManager.on("deviceUnselected", token, (data) => {
console.info('onDeviceUnselected 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('onDeviceUnselected finished.');
});
} catch (err) {
console.error('on failed, cause: ' + JSON.stringify(err));
}

continuationManager.off('deviceSelected')9+

off(type: 'deviceSelected', token: number): void

取消监听设备连接状态。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
typestring是取消监听的事件类型，固定值"deviceSelected"。
tokennumber是注册后的token。

错误码：

以下错误码的详细介绍。

错误码ID错误信息
201Permission denied.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.
16600004The specified callback has been registered.

示例：

import { continuationManager } from '@kit.AbilityKit';

let token: number = 1;
try {
continuationManager.off("deviceSelected", token);
} catch (err) {
console.error('off failed, cause: ' + JSON.stringify(err));
}

continuationManager.off('deviceUnselected')9+

off(type: 'deviceUnselected', token: number): void

取消监听设备断开状态。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
typestring是取消监听的事件类型，固定值"deviceUnselected"。
tokennumber是注册后的token。

错误码：

以下错误码的详细介绍。

错误码ID错误信息
201Permission denied.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.
16600004The specified callback has been registered.

示例：

import { continuationManager } from '@kit.AbilityKit';

let token: number = 1;
try {
continuationManager.off("deviceUnselected", token);
} catch (err) {
console.error('off failed, cause: ' + JSON.stringify(err));
}

continuationManager.startDeviceManager(deprecated)

startDeviceManager(token: number, callback: AsyncCallback<void>): void

拉起设备选择模块，可显示组网内可选择设备列表信息，无过滤条件，使用AsyncCallback方式作为异步方法。

说明

从API version 9开始不再维护，建议使用startContinuationDeviceManager替代。

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
tokennumber是注册后的token。
callbackAsyncCallback<void>是回调函数。当模块选择完成，err为undefined，否则返回错误对象。

示例：

import { continuationManager } from '@kit.AbilityKit';

let token: number = 1;
continuationManager.startDeviceManager(token, (err) => {
  if (err.code != 0) {
    console.error('startDeviceManager failed, cause: ' + JSON.stringify(err));
    return;
  }
  console.info('startDeviceManager finished. ');
});

continuationManager.startDeviceManager(deprecated)

startDeviceManager(token: number, options: ContinuationExtraParams, callback: AsyncCallback<void>): void

拉起设备选择模块，可显示组网内可选择设备列表信息，使用AsyncCallback方式作为异步方法。

说明

从API version 9开始不再维护，建议使用startContinuationDeviceManager替代。

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
tokennumber是注册后的token。
optionsContinuationExtraParams是过滤可选择设备列表的额外参数。
callbackAsyncCallback<void>是回调函数。当模块选择完成，err为undefined，否则返回错误对象。

示例：

import { continuationManager } from '@kit.AbilityKit';

let token: number = 1;
continuationManager.startDeviceManager(
  token,
  {
    deviceType: ["00E"]
  },
  (err) => {
    if (err.code != 0) {
      console.error('startDeviceManager failed, cause: ' + JSON.stringify(err));
      return;
    }
    console.info('startDeviceManager finished. ');
});

continuationManager.startDeviceManager(deprecated)

startDeviceManager(token: number, options?: ContinuationExtraParams): Promise<void>

拉起设备选择模块，可显示组网内可选择设备列表信息，使用Promise方式作为异步方法。

说明

从API version 9开始不再维护，建议使用startContinuationDeviceManager替代。

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
tokennumber是注册后的token。
optionsContinuationExtraParams否过滤可选择设备列表的额外参数，该参数可缺省

返回值：

类型说明
Promise<void>Promise形式返回接口调用结果。

示例：

import { continuationManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let token: number = -1;
continuationManager.startDeviceManager(
token,
{
deviceType: ["00E"]
}).then(() => {
console.info('startDeviceManager finished. ');
}).catch((err: BusinessError) => {
console.error('startDeviceManager failed, cause: ' + JSON.stringify(err));
});

continuationManager.startContinuationDeviceManager9+

startContinuationDeviceManager(token: number, callback: AsyncCallback<void>): void

拉起设备选择模块，可显示组网内可选择设备列表信息，无过滤条件，使用AsyncCallback方式作为异步方法。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
tokennumber是注册后的token。
callbackAsyncCallback<void>是回调函数。当模块选择完成，err为undefined，否则返回错误对象。

错误码：

以下错误码的详细介绍。

错误码ID错误信息
201Permission denied.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.

示例：

import { continuationManager } from '@kit.AbilityKit';

let token: number = -1;
try {
continuationManager.startContinuationDeviceManager(token, (err) => {
if (err.code != 0) {
console.error('startContinuationDeviceManager failed, cause: ' + JSON.stringify(err));
return;
}
console.info('startContinuationDeviceManager finished. ');
});
} catch (err) {
console.error('startContinuationDeviceManager failed, cause: ' + JSON.stringify(err));
}

continuationManager.startContinuationDeviceManager9+

startContinuationDeviceManager(token: number, options: ContinuationExtraParams, callback: AsyncCallback<void>): void

拉起设备选择模块，可显示组网内可选择设备列表信息，使用AsyncCallback方式作为异步方法。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
tokennumber是注册后的token。
optionsContinuationExtraParams是过滤可选择设备列表的额外参数。
callbackAsyncCallback<void>是回调函数。当模块选择完成，err为undefined，否则返回错误对象。

错误码：

以下错误码的详细介绍。

错误码ID错误信息
201Permission denied.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.

示例：

import { continuationManager } from '@kit.AbilityKit';

let token: number = -1;
try {
continuationManager.startContinuationDeviceManager(
token,
{
deviceType: ["00E"]
},
(err) => {
if (err.code != 0) {
console.error('startContinuationDeviceManager failed, cause: ' + JSON.stringify(err));
return;
}
console.info('startContinuationDeviceManager finished. ');
});
} catch (err) {
console.error('startContinuationDeviceManager failed, cause: ' + JSON.stringify(err));
}

continuationManager.startContinuationDeviceManager9+

startContinuationDeviceManager(token: number, options?: ContinuationExtraParams): Promise<void>

拉起设备选择模块，可显示组网内可选择设备列表信息，使用Promise方式作为异步方法。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
tokennumber是注册后的token。
optionsContinuationExtraParams否过滤可选择设备列表的额外参数，该参数可缺省

返回值：

类型说明
Promise<void>Promise形式返回接口调用结果。

错误码：

以下错误码的详细介绍。

错误码ID错误信息
201Permission denied.
401Parameter error. Possible causes: 1. Incorrect parameter types; 2. Parameter verification failed.
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.

示例：

import { continuationManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let token: number = -1;
try {
  continuationManager.startContinuationDeviceManager(
    token,
    {
      deviceType: ["00E"]
    }).then(() => {
      console.info('startContinuationDeviceManager finished. ');
    }).catch((err: BusinessError) => {
      console.error('startContinuationDeviceManager failed, cause: ' + JSON.stringify(err));
    });
} catch (err) {
  console.error('startContinuationDeviceManager failed, cause: ' + JSON.stringify(err));
}

continuationManager.updateConnectStatus(deprecated)

updateConnectStatus(token: number, deviceId: string, status: DeviceConnectState, callback: AsyncCallback<void>): void

通知设备选择模块，更新当前的连接状态，使用AsyncCallback方式作为异步方法。

说明

从API version 9开始不再维护，建议使用updateContinuationState替代。

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
tokennumber是注册后的token。
deviceIdstring是设备ID。
statusDeviceConnectState是设备连接状态。
callbackAsyncCallback<void>是回调函数。当通知设备成功，err为undefined，否则返回错误对象。

示例：

import { continuationManager } from '@kit.AbilityKit';

let token: number = -1;
let deviceId: string = "test deviceId";
continuationManager.updateConnectStatus(token, deviceId, continuationManager.DeviceConnectState.CONNECTED, (err) => {
  if (err.code != 0) {
    console.error('updateConnectStatus failed, cause: ' + JSON.stringify(err));
    return;
  }
  console.info('updateConnectStatus finished. ');
});

continuationManager.updateConnectStatus(deprecated)

updateConnectStatus(token: number, deviceId: string, status: DeviceConnectState): Promise<void>

通知设备选择模块，更新当前的连接状态，使用Promise方式作为异步方法。

说明

从API version 9开始不再维护，建议使用updateContinuationState替代。

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
tokennumber是注册后的token。
deviceIdstring是设备ID。
statusDeviceConnectState是设备连接状态。

返回值：

类型说明
Promise<void>Promise形式返回接口调用结果。

示例：

import { continuationManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let token: number = 1;
let deviceId: string = "test deviceId";
continuationManager.updateConnectStatus(token, deviceId, continuationManager.DeviceConnectState.CONNECTED)
  .then(() => {
    console.info('updateConnectStatus finished. ');
  })
  .catch((err: BusinessError) => {
    console.error('updateConnectStatus failed, cause: ' + JSON.stringify(err));
});

continuationManager.updateContinuationState9+

updateContinuationState(token: number, deviceId: string, status: DeviceConnectState, callback: AsyncCallback<void>): void

通知设备选择模块，更新当前的连接状态，使用AsyncCallback方式作为异步方法。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
tokennumber是注册后的token。
deviceIdstring是设备ID。
statusDeviceConnectState是设备连接状态。
callbackAsyncCallback<void>是回调函数。当通知设备成功，err为undefined，否则返回错误对象。

错误码：

以下错误码的详细介绍。

错误码ID错误信息
201Permission denied.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.

示例：

import { continuationManager } from '@kit.AbilityKit';

let token: number = 1;
let deviceId: string = "test deviceId";
try {
  continuationManager.updateContinuationState(token, deviceId, continuationManager.DeviceConnectState.CONNECTED, (err) => {
    if (err.code != 0) {
      console.error('updateContinuationState failed, cause: ' + JSON.stringify(err));
      return;
    }
    console.info('updateContinuationState finished. ');
  });
} catch (err) {
  console.error('updateContinuationState failed, cause: ' + JSON.stringify(err));
}

continuationManager.updateContinuationState9+

updateContinuationState(token: number, deviceId: string, status: DeviceConnectState): Promise<void>

通知设备选择模块，更新当前的连接状态，使用Promise方式作为异步方法。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
tokennumber是注册后的token。
deviceIdstring是设备ID。
statusDeviceConnectState是设备连接状态。

返回值：

类型说明
Promise<void>Promise形式返回接口调用结果。

错误码：

以下错误码的详细介绍。

错误码ID错误信息
201Permission denied.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.

示例：

import { continuationManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let token: number = 1;
let deviceId: string = "test deviceId";
try {
continuationManager.updateContinuationState(token, deviceId, continuationManager.DeviceConnectState.CONNECTED)
.then(() => {
console.info('updateContinuationState finished. ');
})
.catch((err: BusinessError) => {
console.error('updateContinuationState failed, cause: ' + JSON.stringify(err));
});
} catch (err) {
console.error('updateContinuationState failed, cause: ' + JSON.stringify(err));
}

continuationManager.unregister(deprecated)

unregister(token: number, callback: AsyncCallback<void>): void

解注册流转管理服务，传入注册时获取的token进行解注册，使用AsyncCallback方式作为异步方法。

说明

从API version 9开始不再维护，建议使用unregisterContinuation替代。

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
tokennumber是注册后的token。
callbackAsyncCallback<void>是回调函数。当解注册成功，err为undefined，否则返回错误对象。

示例：

import { continuationManager } from '@kit.AbilityKit';

let token: number = 1;
continuationManager.unregister(token, (err) => {
  if (err.code != 0) {
    console.error('unregister failed, cause: ' + JSON.stringify(err));
    return;
  }
  console.info('unregister finished. ');
});

continuationManager.unregister(deprecated)

unregister(token: number): Promise<void>

解注册流转管理服务，传入注册时获取的token进行解注册，使用Promise方式作为异步方法。

说明

从API version 9开始不再维护，建议使用unregisterContinuation替代。

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
tokennumber是注册后的token。

返回值：

类型说明
Promise<void>Promise形式返回接口调用结果。

示例：

import { continuationManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let token: number = 1;
continuationManager.unregister(token)
.then(() => {
console.info('unregister finished. ');
}).catch((err: BusinessError) => {
console.error('unregister failed, cause: ' + JSON.stringify(err));
});

continuationManager.unregisterContinuation9+

unregisterContinuation(token: number, callback: AsyncCallback<void>): void

解注册流转管理服务，传入注册时获取的token进行解注册，使用AsyncCallback方式作为异步方法。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
tokennumber是注册后的token。
callbackAsyncCallback<void>是回调函数。当解注册成功，err为undefined，否则返回错误对象。

错误码：

以下错误码的详细介绍。

错误码ID错误信息
201Permission denied.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.

示例：

import { continuationManager } from '@kit.AbilityKit';

let token: number = 1;
try {
  continuationManager.unregisterContinuation(token, (err) => {
    if (err.code != 0) {
      console.error('unregisterContinuation failed, cause: ' + JSON.stringify(err));
      return;
    }
    console.info('unregisterContinuation finished. ');
  });
} catch (err) {
  console.error('unregisterContinuation failed, cause: ' + JSON.stringify(err));
}

continuationManager.unregisterContinuation9+

unregisterContinuation(token: number): Promise<void>

解注册流转管理服务，传入注册时获取的token进行解注册，使用Promise方式作为异步方法。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
tokennumber是注册后的token。

返回值：

类型说明
Promise<void>Promise形式返回接口调用结果。

错误码：

以下错误码的详细介绍。

错误码ID错误信息
201Permission denied.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.

示例：

import { continuationManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let token: number = -1;
try {
  continuationManager.unregisterContinuation(token).then(() => {
      console.info('unregisterContinuation finished. ');
    }).catch((err: BusinessError) => {
      console.error('unregisterContinuation failed, cause: ' + JSON.stringify(err));
  });
} catch (err) {
  console.error('unregisterContinuation failed, cause: ' + JSON.stringify(err));
}

DeviceConnectState

设备连接状态。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力：SystemCapability.Ability.DistributedAbilityManager

名称值说明
IDLE0设备连接初始状态。
CONNECTING1设备连接中状态。
CONNECTED2设备已连接状态。
DISCONNECTING3设备断开连接状态。

ContinuationMode

设备选择模块连接模式。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力：SystemCapability.Ability.DistributedAbilityManager

名称值说明
COLLABORATION_SINGLE0设备选择模块单选模式。
COLLABORATION_MULTIPLE1设备选择模块多选模式。

鸿蒙5.0开发进阶：@ohos.app.ability.Want (Want)
Androidbye的博客
11-22 848
Want是对象间信息传递的载体，可以用于应用组件间的信息传递。
HarmonyOS实战开发：@ohos.continuation.continuationManager (continuationManager)
2401_84194030的博客
05-24 887
continuationManager模块提供了流转/协同入口管理服务能力
鸿蒙API13开发【@ohos.continuation.continuationManager (continuationManager)】通用能力的接口
鸿蒙的技术博客
11-29 1029
continuationManager模块提供了流转/协同入口管理服务能力，包括连接/取消流转管理服务，注册/解注册设备连接变化监听，拉起设备选择模块，更新连接状态。
鸿蒙API14开发【@ohos.app.ability.Want (Want)】应用框架api
bbq的博客
04-17 650
Want是对象间信息传递的载体，可以用于应用组件间的信息传递。Want的使用场景之一是作为startAbility的参数，其包含了指定的启动目标，以及启动时需携带的相关数据，例如bundleName和abilityName字段分别指明目标Ability所在应用的包名以及对应包内的Ability名称。当UIAbilityA需要启动UIAbilityB并传入一些数据时，可使用Want作为载体将这些数据传递给UIAbilityB。
【鸿蒙next开发】输入法开发：@ohos.InputMethodExtensionContext (InputMethodExtensionContext)
m0_73088370的博客
07-01 869
本文介绍了鸿蒙HarmonyOS 5.0的InputMethodExtensionContext模块，它是输入法扩展能力的上下文环境，提供销毁输入法和启动目标应用等功能。
鸿蒙5.0开发进阶：Stage模型-@ohos.app.ability.AbilityConstant (AbilityConstant)
Androidbye的博客
11-13 917
AbilityConstant提供UIAbility相关的枚举，包括设置初次启动原因、上次退出原因、迁移结果、窗口类型等。
鸿蒙API14开发【@ohos.continuation.continuationManager (continuationManager)】应用框架api
bbq的博客
04-17 1105
continuationManager模块提供了流转/协同入口管理服务能力，包括连接/取消流转管理服务，注册/解注册设备连接变化监听，拉起设备选择模块，更新连接状态。
鸿蒙NEXT开发：FA模型能力的接口-@ohos.app.ability.Want (Want)
ZPYQAQ的博客
03-02 818
Want是对象间信息传递的载体，可以用于应用组件间的信息传递。
鸿蒙5.0开发进阶：ArkTS API-UIAbilityContext
Androidbye的博客
11-29 1242
UIAbilityContext是需要保存状态的UIAbility所对应的context.........
鸿蒙Qt字体实战：消灭“豆腐块“乱码与自定义字体加载
小淼淼的博客
11-23 504
Qt应用移植到鸿蒙系统时常见中文字体显示为方框（"豆腐块"）问题，主要原因是系统字体回退失败或自定义字体加载路径错误。解决方案包括：显式指定系统字体、将字体文件拷贝到沙箱目录再加载、在QML中正确使用FontLoader引用字体名称。此外还需注意High DPI适配问题，通过设置环境变量或手动调整缩放因子来优化字体渲染效果。建议打包开源中文字体随App发布，确保字体在不同设备上都能正常显示。
鸿蒙Cordova开发踩坑记录：LocalStorage的“失忆症“
小淼淼的博客
11-24 645
摘要：本文揭示了鸿蒙混合开发中LocalStorage数据丢失问题，发现应用更新或重签名会导致沙箱重建，使WebView存储目录失效。为解决该问题，提出基于Native Preferences的持久化方案：1）封装NativeStorage插件通过JSBridge与前端交互；2）采用双写策略同步LocalStorage与Native存储；3）启动时实施数据迁移确保兼容性。同时强调避免存储大对象、保持签名一致及合理控制flush时机等注意事项。最终建议采用"LocalStorage+Preferen
HarmonyOS在智能穿戴中的生物识别
2509_93942294的博客
11-25 296
系统能通过这些细微的、节律性的变化，不仅确认“是你”，还能推断出你的情绪压力水平、睡眠阶段甚至潜在的健康风险。举个例子，手表采集到你的心电原始数据，可以通过分布式软总线，安全地流转到你的手机上进行更复杂的算法分析（比如房颤筛查），分析结果再回流到手表显示。心电的波形，特别是P波、QRS波群、T波的形态、间隔和幅度，是比心率更为复杂和个性化的生物标识。无缝身份认证： 系统可以综合你的心率模式、活动状态等连续生物特征，在你拿起手机或靠近电脑时，实现无感的自动解锁，真正做到“你就是密码”。
【HarmonyOS 6】在UI控件上滑动也会触发onClick点击事件？
路漫漫亦无涯
11-24 60
HarmonyOS 6开发中遇到滑动触发onClick事件的问题，原因是滑动后抬起手指会触发默认点击事件。从API12开始，onClick新增distanceThreshold参数可设置移动阈值，当手指移动超过该阈值时点击识别失败。解决方案是在onClick中添加distanceThreshold参数并设置为1vp，这样轻微滑动就不会误触发点击事件。本文通过示例代码演示了问题复现和解决方法，提醒开发者注意API新特性的使用。
HarmonyOS在智能家居中的应用
2509_93947344的博客
11-25 215
其二是统一控制中心带来的操作革新。更值得称道的是，系统能基于场景需求智能组合设备功能：在影院模式下，不仅会自动调整灯光和窗帘，还会同步优化音响效果，创造沉浸式的观影环境。基于统一的ArkUI开发框架，应用可以自适应不同设备的屏幕尺寸和交互方式，这为智能家居生态带来了更丰富的应用可能。所有设备间的通信都经过端到端加密，数据访问需要用户授权，更重要的是，敏感数据处理尽可能在本地完成，最大限度保障用户隐私。在这个万物互联的时代，HarmonyOS以其独特的技术架构，为智能家居的发展提供了新的解题思路。
HarmonyOS在智能家居中的场景联动
2509_93945719的博客
11-25 275
传统智能家居的痛点在于，每个设备都是信息孤岛。比如在观影场景中，当你拿起华为智慧屏的遥控器，客厅灯光会自动调暗，窗帘缓缓关闭，音箱切换为影院模式——这些操作无需你逐个设置，系统通过原子化服务自动识别你的意图并触发联动。这种跨设备的即时响应，传统智能家居需要借助云端中转，存在1-3秒延迟，而HarmonyOS的分布式软总线实现了设备间端到端的直接通信，将响应时间压缩到毫秒级。其次是设备发现机制，HarmonyOS的碰一碰配网确实简化了入网流程，但建议在施工阶段就规划好所有设备的安装位置，避免后期信号盲区。
HarmonyOS在智能汽车中的V2X通信
2509_93942660的博客
11-25 310
某次测试中，我们通过HarmonyOS的原子化服务特性，让车辆在通过十字路口时直接调用路侧摄像头的实时视频流，这种打破设备边界的体验确实让人眼前一亮。在通信协议适配层，HarmonyOS搞了个很有意思的设计。我们在路测时发现，基于HarmonyOS的终端在接收V2X消息时会执行三重验证：首先是证书链验证，接着对发送方设备进行可信环境检测，最后还会对消息内容进行场景合理性分析。更夸张的是，我们团队用分布式数据管理功能，三天就实现了车辆与智慧路灯的数据同步——这在过去至少需要协调三个供应商开半个月技术联调会。
HarmonyOS在智能车载中的导航系统
2509_93945680的博客
11-25 350
用户无需下载完整APP，需要查充电桩、找停车场时，直接唤醒对应服务卡片，用完即走，不占内存，却享受全量功能。但方向已经清晰：HarmonyOS正推动车载导航从“静态地图展示”走向“动态场景服务”，从“单一功能模块”升级为“出行中枢神经”。下一次当你坐进搭载HarmonyOS的汽车，或许会发现导航不再是你需要操作的功能，而是一位真正懂路、懂车、懂你的沉默领航员。在确保隐私安全的前提下，HarmonyOS能通过匿名化采集脱敏数据（如急刹车位置、频繁变道路段），结合云端AI分析，动态优化路线算法。
HarmonyOS权限管理系统
最新发布
2509_93945744的博客
11-25 299
鸿蒙通过构建分布式权限管理框架，能够确保当设备A上的应用需要访问设备B上的资源时，其权限申请和验证过程对用户而言依然是透明和可控的，保障了整个分布式生态的安全基线。用户可以随时在“设置”-“应用管理”中，对任何已安装应用的权限进行查看、修改或撤销。清晰的解释说明：在动态申请前或申请被拒绝后，通过界面文案向用户清晰、诚实地解释为何需要该权限，以及禁用后对功能的影响，争取用户的理解和信任。一个值得关注的细节是，HarmonyOS的弹窗会明确展示权限所属的“权限组”，这有助于用户理解授权行为的实质，避免被误导。
jq 在 HarmonyOS 上的构建与适配
Pocker_Spades_A的博客
11-24 630
jq是一个轻量级、灵活的命令行 JSON 处理器，类似于sedawkgrep等工具，但专门用于处理 JSON 数据。它使用可移植的 C 语言编写，零运行时依赖，可以轻松地切片、过滤、映射和转换结构化数据。v1.71.7_ohos构建系统识别：Autotools 项目需要autoreconf和configure子模块处理：正确处理 git submodule 的初始化和配置目标平台选择：使用而不是C 预处理器配置：使用clang -E而不是clang++config.h 生成：处理的问题，提供回退方案。
ERROR 3659: Illegal backslash. Backslash is line continuation character.
10-23
### ERROR 3988: Illegal command syntax 对于“ERROR 3988: Illegal command syntax”错误，一般可从以下方面排查解决： - **检查命令拼写**：要保证输入命令时无拼写错误，涵盖命令关键字、参数名称等。例如留意命令中的字母大小写、特殊字符是否正确。 - **检查命令格式**：不同命令有特定格式要求，需严格按规定格式输入，如命令参数的顺序、数量，是否需要特定分隔符等。 - **查看命令文档**：查阅Evolver的官方文档，了解该命令的正确使用方法和适用场景，确认输入的命令是否符合要求。 - **检查环境配置**：某些命令的正常使用可能依赖于特定的环境配置，如变量设置、文件路径等，需检查这些环境配置是否正确。 ### ERROR 3659: Illegal backslash. Backslash is line continuation character “ERROR 3659: Illegal backslash. Backslash is line continuation character”错误表明反斜杠使用不当，反斜杠在Evolver里是行延续字符。可参考以下解决办法： - **检查反斜杠使用**：确认在命令中反斜杠是否用在了正确位置，是否符合行延续的规则。比如，若在不需要行延续的地方使用了反斜杠，就会引发此错误。 - **检查代码换行处**：当代码换行时，要保证反斜杠正确使用以延续命令。若换行处反斜杠缺失或多余，都可能导致错误。 示例代码（假设是简单的命令检查）： ```python def check_commands(command): if "ERROR 3988" in command: print("请检查命令的拼写和格式是否正确。") elif "ERROR 3659" in command: print("请检查反斜杠的使用是否正确。") return command user_command = "evolver some_command ERROR 3988: Illegal command syntax" checked_command = check_commands(user_command) ```
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值