harmony 鸿蒙@ohos.continuation.continuationManager (continuationManager)

2022-08-09 浏览 (761)

@ohos.continuation.continuationManager (continuationManager)

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

本模块接口用于拉起系统中的设备选择模块，由于该模块功能暂不完备，因此流转能力整体暂不支持用于应用开发。

说明：

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

导入模块

import continuationManager from '@ohos.continuation.continuationManager'

continuationManager.register(deprecated)

register(callback: AsyncCallback<number>): void;

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

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

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

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

示例：

import continuationManager from '@ohos.continuation.continuationManager'
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 '@ohos.continuation.continuationManager'
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 '@ohos.continuation.continuationManager'
import { BusinessError } from '@ohos.base';
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方式作为异步方法。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

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

错误码：

以下错误码的详细介绍请参见分布式调度错误码。

错误码ID错误信息
16600001The system ability works abnormally.
16600003The number of token registration times has reached the upper limit.

示例：

import continuationManager from '@ohos.continuation.continuationManager'
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方式作为异步方法。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

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

错误码：

以下错误码的详细介绍请参见分布式调度错误码。

错误码ID错误信息
16600001The system ability works abnormally.
16600003The number of token registration times has reached the upper limit.

示例：

import continuationManager from '@ohos.continuation.continuationManager';
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方式作为异步方法。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

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

返回值：

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

错误码：

以下错误码的详细介绍请参见分布式调度错误码。

错误码ID错误信息
16600001The system ability works abnormally.
16600003The number of token registration times has reached the upper limit.

示例：

import continuationManager from '@ohos.continuation.continuationManager';
import { BusinessError } from '@ohos.base';
let token: number = -1;
try {
  continuationManager.register(
    {
      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 '@ohos.continuation.continuationManager';
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 '@ohos.continuation.continuationManager';
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 '@ohos.continuation.continuationManager';
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 '@ohos.continuation.continuationManager';
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形式返回连接的设备信息。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

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

错误码：

以下错误码的详细介绍请参见分布式调度错误码。

错误码ID错误信息
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.
16600004The specified callback has been registered.

示例：

import continuationManager from '@ohos.continuation.continuationManager';
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形式返回断开的设备信息。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

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

错误码：

以下错误码的详细介绍请参见分布式调度错误码。

错误码ID错误信息
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.
16600004The specified callback has been registered.

示例：

import continuationManager from '@ohos.continuation.continuationManager';
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;

取消监听设备连接状态。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

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

错误码：

以下错误码的详细介绍请参见分布式调度错误码。

错误码ID错误信息
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.
16600004The specified callback has been registered.

示例：

import continuationManager from '@ohos.continuation.continuationManager';
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;

取消监听设备断开状态。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

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

错误码：

以下错误码的详细介绍请参见分布式调度错误码。

错误码ID错误信息
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.
16600004The specified callback has been registered.

示例：

import continuationManager from '@ohos.continuation.continuationManager';
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>是AsyncCallback形式返回接口调用结果。

示例：

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

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>是AsyncCallback形式返回接口调用结果。

示例：

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

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 '@ohos.continuation.continuationManager';
import { BusinessError } from '@ohos.base';
let token: number = -1;
continuationManager.startDeviceManager(
  token,
  {
    deviceType: ["00E"]
  }).then((data) => {
    console.info('startDeviceManager finished, ' + JSON.stringify(data));
  }).catch((err: BusinessError) => {
    console.error('startDeviceManager failed, cause: ' + JSON.stringify(err));
});

continuationManager.startContinuationDeviceManager9+

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

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

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
tokennumber是注册后的token。
callbackAsyncCallback<void>是AsyncCallback形式返回接口调用结果。

错误码：

以下错误码的详细介绍请参见分布式调度错误码。

错误码ID错误信息
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.

示例：

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

continuationManager.startContinuationDeviceManager9+

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

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

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
tokennumber是注册后的token。
optionsContinuationExtraParams是过滤可选择设备列表的额外参数。
callbackAsyncCallback<void>是AsyncCallback形式返回接口调用结果。

错误码：

以下错误码的详细介绍请参见分布式调度错误码。

错误码ID错误信息
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.

示例：

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

continuationManager.startContinuationDeviceManager9+

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

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

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

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

返回值：

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

错误码：

以下错误码的详细介绍请参见分布式调度错误码。

错误码ID错误信息
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.

示例：

import continuationManager from '@ohos.continuation.continuationManager';
import { BusinessError } from '@ohos.base';
let token: number = -1;
try {
  continuationManager.startContinuationDeviceManager(
    token,
    {
      deviceType: ["00E"]
    }).then((data) => {
      console.info('startContinuationDeviceManager finished, ' + JSON.stringify(data));
    }).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>是AsyncCallback形式返回接口调用结果。

示例：

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

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 '@ohos.continuation.continuationManager';
import { BusinessError } from '@ohos.base';
let token: number = 1;
let deviceId: string = "test deviceId";
continuationManager.updateConnectStatus(token, deviceId, continuationManager.DeviceConnectState.CONNECTED)
  .then((data) => {
    console.info('updateConnectStatus finished, ' + JSON.stringify(data));
  })
  .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方式作为异步方法。

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
tokennumber是注册后的token。
deviceIdstring是设备ID。
statusDeviceConnectState是设备连接状态。
callbackAsyncCallback<void>是AsyncCallback形式返回接口调用结果。

错误码：

以下错误码的详细介绍请参见分布式调度错误码。

错误码ID错误信息
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.

示例：

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

continuationManager.updateContinuationState9+

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

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

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

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

返回值：

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

错误码：

以下错误码的详细介绍请参见分布式调度错误码。

错误码ID错误信息
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.

示例：

import continuationManager from '@ohos.continuation.continuationManager';
import { BusinessError } from '@ohos.base';
let token: number = 1;
let deviceId: string = "test deviceId";
try {
  continuationManager.updateContinuationState(token, deviceId, continuationManager.DeviceConnectState.CONNECTED)
    .then((data) => {
      console.info('updateContinuationState finished, ' + JSON.stringify(data));
    })
    .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>是AsyncCallback形式返回接口调用结果。

示例：

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

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 '@ohos.continuation.continuationManager';
import { BusinessError } from '@ohos.base';
let token: number = 1;
continuationManager.unregister(token)
  .then((data) => {
    console.info('unregister finished, ' + JSON.stringify(data));
  }).catch((err: BusinessError) => {
    console.error('unregister failed, cause: ' + JSON.stringify(err));
});

continuationManager.unregisterContinuation9+

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

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

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

参数名类型必填说明
tokennumber是注册后的token。
callbackAsyncCallback<void>是AsyncCallback形式返回接口调用结果。

错误码：

以下错误码的详细介绍请参见分布式调度错误码。

错误码ID错误信息
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.

示例：

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

continuationManager.unregisterContinuation9+

unregisterContinuation(token: number): Promise<void>;

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

需要权限：ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.DistributedAbilityManager

参数：

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

返回值：

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

错误码：

以下错误码的详细介绍请参见分布式调度错误码。

错误码ID错误信息
16600001The system ability works abnormally.
16600002The specified token or callback is not registered.

示例：

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

DeviceConnectState

设备连接状态。

系统能力：SystemCapability.Ability.DistributedAbilityManager

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

ContinuationMode

设备选择模块连接模式。

系统能力：SystemCapability.Ability.DistributedAbilityManager

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

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

harmony 鸿蒙系统公共事件定义(待停用)

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

harmony 鸿蒙企业设备管理概述（仅对系统应用开放）

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)

harmony 鸿蒙@ohos.distributedBundle (分布式包管理)

harmony 鸿蒙@ohos.bundle (Bundle模块)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)

  • 所属分类： 后端技术
  • 本文标签： 软件 鸿蒙
  • 版权声明： 本文链接 https://seaxiang.com/blog/1386cc7e43ad4b028cf9e9c4e4b43191