harmony 鸿蒙@ohos.cooperate (键鼠穿越)（系统接口）

2025-06-12
浏览 (3)

@ohos.cooperate (键鼠穿越)（系统接口）

键鼠穿越功能模块，提供两台或多台设备组网协同后键鼠共享能力，实现键鼠输入设备的跨设备协同操作。

说明

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

本模块接口均为系统接口。

导入模块

import cooperate from '@ohos.cooperate';

cooperate.prepareCooperate¹¹⁺

prepareCooperate(callback: AsyncCallback<void>): void;

准备键鼠穿越，使用Callback异步回调。

需要权限：ohos.permission.COOPERATE_MANAGER

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
callback	AsyncCallback<void>	是	回调函数，准备键鼠穿越成功时，err为undefined，否则为错误对象。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
201	Permission denied.
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

import { BusinessError } from '@ohos.base';
try {
  cooperate.prepareCooperate((error: BusinessError) => {
    if (error) {
      console.log(`Keyboard mouse crossing prepareCooperate failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
      return;
    }
    console.log(`Keyboard mouse crossing prepareCooperate success.`);
  });
} catch (error) {
  console.log(`Keyboard mouse crossing prepareCooperate failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

cooperate.prepareCooperate¹¹⁺

prepareCooperate(): Promise<void>;

准备键鼠穿越，使用Promise异步方式返回结果。

需要权限：ohos.permission.COOPERATE_MANAGER

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

返回值：

参数	说明
Promise<void>	无返回结果的Promise对象。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
201	Permission denied.
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

import { BusinessError } from '@ohos.base';
try {
  cooperate.prepareCooperate().then(() => {
    console.log(`Keyboard mouse crossing prepareCooperate success.`);
  }, (error: BusinessError) => {
    console.log(`Keyboard mouse crossing prepareCooperate failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
  });
} catch (error) {
  console.log(`Keyboard mouse crossing prepareCooperate failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

cooperate.unprepareCooperate¹¹⁺

unprepareCooperate(callback: AsyncCallback<void>): void;

取消键鼠穿越准备，使用Callback异步回调。

需要权限：ohos.permission.COOPERATE_MANAGER

系统能力: SystemCapability.Msdp.DeviceStatus.Cooperate

参数名	类型	必填	说明
callback	AsyncCallback<void>	是	回调函数，取消键鼠穿越准备成功时，err为undefined，否则为错误对象。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
201	Permission denied.
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

import { BusinessError } from '@ohos.base';
try {
  cooperate.unprepareCooperate((error: BusinessError) => {
    if (error) {
      console.log(`Keyboard mouse crossing unprepareCooperate failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
      return;
    }
    console.log(`Keyboard mouse crossing unprepareCooperate success.`);
  });
} catch (error) {
  console.log(`Keyboard mouse crossing unprepareCooperate failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

cooperate.unprepareCooperate¹¹⁺

unprepareCooperate(): Promise<void>;

取消键鼠穿越准备，使用Promise异步回调。

需要权限：ohos.permission.COOPERATE_MANAGER

系统能力: SystemCapability.Msdp.DeviceStatus.Cooperate

返回值：

参数	说明
Promise<void>	无返回结果的Promise对象。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
201	Permission denied.
202	Not system application.

示例：

import { BusinessError } from '@ohos.base';
try {
  cooperate.unprepareCooperate().then(() => {
    console.log(`Keyboard mouse crossing unprepareCooperate success.`);
  }, (error: BusinessError) => {
    console.log(`Keyboard mouse crossing unprepareCooperate failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
  });
} catch (error) {
  console.log(`Keyboard mouse crossing unprepareCooperate failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

cooperate.activateCooperate¹¹⁺

activateCooperate(targetNetworkId: string, inputDeviceId: number, callback: AsyncCallback<void>): void;

启动键鼠穿越，使用Callback异步回调。

需要权限：ohos.permission.COOPERATE_MANAGER

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
targetNetworkId	string	是	键鼠穿越目标设备描述符。
inputDeviceId	number	是	待穿越输入设备标识符。
callback	AsyncCallback<void>	是	回调函数，键鼠穿越启动成功时，err为undefined，否则为错误对象。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
201	Permission denied.
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.
20900001	Service exception. Possible causes: 1. A system error, such as null pointer, container-related exception, or IPC exception. 2. N-API invocation exception or invalid N-API status.

示例：

import { BusinessError } from '@ohos.base';
let targetNetworkId = "networkId";
let inputDeviceId = 0;
try {
  cooperate.activateCooperate(targetNetworkId, inputDeviceId, (error: BusinessError) => {
    if (error) {
      console.log(`Start Keyboard mouse crossing failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
      return;
    }
    console.log(`Start Keyboard mouse crossing success.`);
  });
} catch (error) {
  console.log(`Start Keyboard mouse crossing failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

cooperate.activateCooperate¹¹⁺

activateCooperate(targetNetworkId: string, inputDeviceId: number): Promise<void>;

启动键鼠穿越，使用Promise异步回调。

需要权限：ohos.permission.COOPERATE_MANAGER

系统能力: SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
targetNetworkId	string	是	键鼠穿越目标设备描述符。
inputDeviceId	number	是	待穿越输入设备标识符。

返回值：

参数名	说明
Promise<void>	无返回结果的Promise对象。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
201	Permission denied.
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.
20900001	Service exception. Possible causes: 1. A system error, such as null pointer, container-related exception, or IPC exception. 2. N-API invocation exception or invalid N-API status.

示例：

import { BusinessError } from '@ohos.base';
let targetNetworkId = "networkId";
let inputDeviceId = 0;
try {
 cooperate.activateCooperate(targetNetworkId, inputDeviceId).then(() => {
    console.log(`Start Keyboard mouse crossing success.`);
  }, (error: BusinessError) => {
    console.log(`Start Keyboard mouse crossing failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
  });
} catch (error) {
  console.log(`Start Keyboard mouse crossing failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

cooperate.deactivateCooperate¹¹⁺

deactivateCooperate(isUnchained: boolean, callback: AsyncCallback<void>): void;

停止键鼠穿越，使用Callback异步回调。

需要权限：ohos.permission.COOPERATE_MANAGER

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
isUnchained	boolean	是	是否关闭跨设备链路。 ture表示关闭跨设备链路，false表示不关闭。
callback	AsyncCallback<void>	是	回调函数，键鼠穿越停止成功时，err为undefined，否则为错误对象。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
201	Permission denied.
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

import { BusinessError } from '@ohos.base';
try {
  cooperate.deactivateCooperate(false, (error: BusinessError) => {
    if (error) {
      console.log(`Stop Keyboard mouse crossing failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
      return;
    }
    console.log(`Stop Keyboard mouse crossing success.`);
  });
} catch (error) {
  console.log(`Stop Keyboard mouse crossing failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

cooperate.deactivateCooperate¹¹⁺

deactivateCooperate(isUnchained: boolean): Promise<void>;

停止键鼠穿越，使用Promise异步回调。

需要权限：ohos.permission.COOPERATE_MANAGER

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
isUnchained	boolean	是	是否关闭跨设备链路。 ture表示关闭跨设备链路，false表示不关闭。

返回值：

参数名	说明
Promise<void>	无返回结果的Promise对象。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
201	Permission denied.
202	Not system application.

示例：

import { BusinessError } from '@ohos.base';
try {
  cooperate.deactivateCooperate(false).then(() => {
    console.log(`Stop Keyboard mouse crossing success.`);
  }, (error: BusinessError) => {
    console.log(`Stop Keyboard mouse crossing failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
  });
} catch (error) {
  console.log(`Stop Keyboard mouse crossing failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

cooperate.getCooperateSwitchState¹¹⁺

getCooperateSwitchState(networkId: string, callback: AsyncCallback<boolean>): void;

获取目标设备键鼠穿越开关的状态，使用Callback异步回调。

需要权限：ohos.permission.COOPERATE_MANAGER

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
networkId	string	是	键鼠穿越目标设备描述符。
callback	AsyncCallback<boolean>	是	回调函数，返回ture表示目标设备键鼠穿越的开关开启，返回false表示开关未开启。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
201	Permission denied.
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

import { BusinessError } from '@ohos.base';
let deviceDescriptor = "networkId";
try {
  cooperate.getCooperateSwitchState(deviceDescriptor, (error: BusinessError, data: boolean) => {
    if (error) {
      console.log(`Get the status failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
      return;
    }
    console.log(`Get the status success, data: ${JSON.stringify(data)}`);
  });
} catch (error) {
  console.log(`Get the status failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

cooperate.getCooperateSwitchState¹¹⁺

getCooperateSwitchState(networkId: string): Promise<boolean>;

获取目标设备键鼠穿越开关的状态，使用Promise异步方式返回结果。

需要权限：ohos.permission.COOPERATE_MANAGER

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
networkId	string	是	键鼠穿越目标设备描述符。

返回值：

参数	说明
Promise<boolean>	Promise对象，返回ture表示目标设备键鼠穿越的开关开启，返回false表示开关未开启。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
201	Permission denied.
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

import { BusinessError } from '@ohos.base';
let deviceDescriptor = "networkId";
try {
  cooperate.getCooperateSwitchState(deviceDescriptor).then((data: boolean) => {
    console.log(`Get the status success, data: ${JSON.stringify(data)}`);
  }, (error: BusinessError) => {
    console.log(`Get the status failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
  });
} catch (error) {
  console.log(`Get the status failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

on(‘cooperateMessage’)¹¹⁺

on(type: ‘cooperateMessage’, callback: Callback<CooperateMessage>): void;

注册监听键鼠穿越状态。

需要权限：ohos.permission.COOPERATE_MANAGER

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
type	string	是	监听类型，取值为’cooperateMessage’
callback	Callback<CooperateMessage>	是	回调函数，异步返回键鼠穿越状态消息。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
201	Permission denied.
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

function callback(msg: cooperate.CooperateMessage) {
  console.log(`Keyboard mouse crossing event: ${JSON.stringify(msg)}`);
  return false;
}
try {
  cooperate.on('cooperateMessage', callback);
} catch (error) {
  console.log(`Register failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

off(‘cooperateMessage’)¹¹⁺

off(type: ‘cooperateMessage’, callback?: Callback<CooperateMessage>): void;

取消监听键鼠穿越状态。

需要权限：ohos.permission.COOPERATE_MANAGER

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
type	string	是	监听类型，取值为’cooperate’。
callback	Callback<CooperateMessage>	否	需要取消注册的回调函数，若无此参数，则取消当前应用注册的所有回调函数。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
201	Permission denied.
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

// 取消注册单个回调函数
function callbackOn(msgOn: cooperate.CooperateMessage) {
  console.log(`Keyboard mouse crossing event: ${JSON.stringify(msgOn)}`);
  return false;
}
function callbackOff(msgOff: cooperate.CooperateMessage) {
  console.log(`Keyboard mouse crossing event: ${JSON.stringify(msgOff)}`);
  return false;
}
try {
  cooperate.on('cooperateMessage', callbackOn);
  cooperate.off('cooperateMessage', callbackOff);
} catch (error) {
  console.log(`Execute failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

// 取消注册所有回调函数
function callbackOn(msg: cooperate.CooperateMessage) {
  console.log(`Keyboard mouse crossing event: ${JSON.stringify(msg)}`);
  return false;
}
try {
  cooperate.on('cooperateMessage', callbackOn);
  cooperate.off('cooperateMessage');
} catch (error) {
  console.log(`Execute failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

on(‘cooperateMouse’)¹²⁺

on(type: ‘cooperateMouse’, networkId: string, callback: Callback<MouseLocation>): void;

注册监听指定设备鼠标光标位置。

需要权限：ohos.permission.COOPERATE_MANAGER

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
type	string	是	监听类型，取值为’cooperateMouse’
networkId	string	是	目标设备描述符
callback	Callback<MouseLocation>	是	回调函数，异步返回指定监听设备鼠标光标位置信息。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
201	Permission denied.
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

function callback(data: cooperate.MouseLocation) {
  console.log('displayX:' + data.displayX + 'displayY:' + data.displayX + 'displayWidth:' +
    data.displayWidth + 'displayHeight:' + data.displayHeight );
}
try {
  let networkId: string = 'Default';
  cooperate.on('cooperateMouse', networkId, callback);
} catch (error) {
  console.log(`Register failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

off(‘cooperateMouse’)¹²⁺

off(type: ‘cooperateMouse’, networkId: string, callback?: Callback<MouseLocation>): void;

取消监听指定设备鼠标光标位置。

需要权限：ohos.permission.COOPERATE_MANAGER

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
type	string	是	监听类型，取值为’cooperateMouse’。
networkId	string	是	目标设备描述符
callback	Callback<MouseLocation>	否	需要取消注册的回调函数，若无此参数，则取消当前应用注册的所有回调函数。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
201	Permission denied.
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

// 取消注册单个回调函数
function callbackOn(data: cooperate.MouseLocation) {
  console.log('Register mouse location listener');
  return false;
}
function callbackOff(data: cooperate.MouseLocation) {
  console.log('Unregister mouse location listener');
  return false;
}
try {
  let networkId: string = 'Default';
  cooperate.on('cooperateMouse', networkId, callbackOn);
  cooperate.off('cooperateMouse', networkId, callbackOff);
} catch (error) {
  console.log(`Execute failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

// 取消注册所有回调函数
function callbackOn(data: cooperate.MouseLocation) {
  console.log('Register mouse location listener');
}
try {
  let networkId: string = 'Default';
  cooperate.on('cooperateMouse', networkId, callbackOn);
  cooperate.off('cooperateMouse', networkId);
} catch (error) {
  console.log(`Execute failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

cooperate.activateCooperateWithOptions²⁰⁺

activateCooperateWithOptions(targetNetworkId: string, inputDeviceId: number, cooperateOptions?: CooperateOptions ): Promise<void>

启动键鼠穿越，使用选项开始屏幕跳转。

需要权限：ohos.permission.COOPERATE_MANAGER

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
targetNetworkId	string	是	键鼠穿越目标设备描述符。
inputDeviceId	number	是	发起穿越操作的输入设备ID。
cooperateOptions	CooperateOptions	否	穿越可选控制参数，控制穿出点位置。

返回值：

参数	说明
Promise<void>	无返回结果的Promise对象。

错误码：

以下错误码详细介绍请参考通用错误码和ohos.devicestatus错误码。

错误码ID	错误信息
201	Permission denied.
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.
20900001	Service exception. Possible causes: 1. A system error, such as null pointer, container-related exception, or IPC exception. 2. N-API invocation exception or invalid N-API status.

示例：

import { BusinessError } from '@ohos.base';
let targetNetworkId = "networkId";
let inputDeviceId = 0;
try {
 cooperate.activateCooperateWithOptions(targetNetworkId, inputDeviceId).then(() => {
    console.info(`activateCooperateWithOptions success.`);
  }, (error: BusinessError) => {
    console.error(`activateCooperateWithOptions, error: ${JSON.stringify(error, [`code`, `message`])}`);
  });
} catch (error) {
  console.error(`activateCooperateWithOptions, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

CooperateMessage¹¹⁺

键鼠穿越的消息。

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

名称	类型	可读	可写	说明
networkId	string	是	否	键鼠穿越目标设备描述符。
state	CooperateState	是	否	键鼠穿越的状态。

MouseLocation¹²⁺

键鼠穿越的位置。

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

名称	类型	可读	可写	说明
displayX	number	是	否	鼠标指针位于屏幕的X坐标上的位置。
displayY	number	是	否	鼠标指针位于屏幕的y坐标上的位置。
displayWidth	number	是	否	屏幕宽度，单位：px。
displayHeight	number	是	否	屏幕高度，单位：px。

CooperateState¹¹⁺

键鼠穿越的状态。

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

名称	类型	可读	可写	说明
COOPERATE_PREPARE	number	是	否	表示准备键鼠穿越。
COOPERATE_UNPREPARE	number	是	否	表示取消键鼠穿越准备。
COOPERATE_ACTIVATE	number	是	否	表示启动键鼠穿越。
COOPERATE_ACTIVATE_SUCCESS	number	是	否	表示键鼠穿越启动成功。
COOPERATE_ACTIVATE_FAIL	number	是	否	表示键鼠穿越启动失败。
COOPERATE_DEACTIVATE_SUCCESS	number	是	否	表示键鼠穿越停止成功。
COOPERATE_DEACTIVATE_FAIL	number	是	否	表示键鼠穿越停止失败。
COOPERATE_SESSION_DISCONNECTED	number	是	否	表示键鼠穿越会话断开。
COOPERATE_ACTIVATE_FAILURE	number	是	否	表示键鼠穿越无法启动。
COOPERATE_DEACTIVATE_FAILURE	number	是	否	表示键鼠穿越无法停止。

MouseLocation¹²⁺

鼠标光标位置信息。

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

名称	类型	可读	可写	说明
displayX	number	是	否	鼠标X坐标位置。
displayY	number	是	否	鼠标Y坐标位置。
displayWidth	number	是	否	鼠标所在屏幕宽度，单位：px。
displayHeight	number	是	否	鼠标所在屏幕高度，单位：px。

CooperateOptions²⁰⁺

键鼠穿越可选控制参数，控制穿出点位置。

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

名称	类型	只读	可选	说明
displayX	number	否	否	鼠标X坐标位置。
displayY	number	否	否	鼠标Y坐标位置。
displayId	number	否	否	对端设备屏幕标识。

cooperate.prepare^(deprecated)

prepare(callback: AsyncCallback<void>): void;

准备键鼠穿越，使用Callback异步回调。

说明：

从API version 10开始不在维护。建议使用cooperate.prepareCooperate替代

系统能力: SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
callback	AsyncCallback<void>	是	回调函数，准备键鼠穿越成功时，err为undefined，否则为错误对象。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

import { BusinessError } from '@ohos.base';
try {
  cooperate.prepare((error: BusinessError) => {
    if (error) {
      console.log(`Keyboard mouse crossing prepare failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
      return;
    }
    console.log(`Keyboard mouse crossing prepare success.`);
  });
} catch (error) {
  console.log(`Keyboard mouse crossing prepare failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

cooperate.prepare^(deprecated)

prepare(): Promise<void>;

准备键鼠穿越，使用Promise异步方式返回结果。

说明：

从API version 10开始不在维护。建议使用cooperate.prepareCooperate替代

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

返回值：

参数	说明
Promise<void>	无返回结果的Promise对象。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

import { BusinessError } from '@ohos.base';
try {
  cooperate.prepare().then(() => {
    console.log(`Keyboard mouse crossing prepare success.`);
  }, (error: BusinessError) => {
    console.log(`Keyboard mouse crossing prepare failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
  });
} catch (error) {
  console.log(`Keyboard mouse crossing prepare failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

cooperate.unprepare^(deprecated)

unprepare(callback: AsyncCallback<void>): void;

取消键鼠穿越准备，使用Callback异步回调。

说明：

从API version 10开始不在维护。建议使用cooperate.unprepareCooperate替代

系统能力: SystemCapability.Msdp.DeviceStatus.Cooperate

参数名	类型	必填	说明
callback	AsyncCallback<void>	是	回调函数，取消键鼠穿越准备成功时，err为undefined，否则为错误对象。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

import { BusinessError } from '@ohos.base';
try {
  cooperate.unprepare((error: BusinessError) => {
    if (error) {
      console.log(`Keyboard mouse crossing unprepare failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
      return;
    }
    console.log(`Keyboard mouse crossing unprepare success.`);
  });
} catch (error) {
  console.log(`Keyboard mouse crossing unprepare failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

cooperate.unprepare^(deprecated)

unprepare(): Promise<void>;

取消键鼠穿越准备，使用Promise异步回调。

说明：

从API version 10开始不在维护。建议使用cooperate.unprepareCooperate替代

系统能力: SystemCapability.Msdp.DeviceStatus.Cooperate

返回值：

参数	说明
Promise<void>	无返回结果的Promise对象。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

import { BusinessError } from '@ohos.base';
try {
  cooperate.unprepare().then(() => {
    console.log(`Keyboard mouse crossing unprepare success.`);
  }, (error: BusinessError) => {
    console.log(`Keyboard mouse crossing unprepare failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
  });
} catch (error) {
  console.log(`Keyboard mouse crossing unprepare failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

cooperate.activate^(deprecated)

activate(targetNetworkId: string, inputDeviceId: number, callback: AsyncCallback<void>): void;

启动键鼠穿越，使用Callback异步回调。

说明：

从API version 10开始不在维护。建议使用cooperate.activateCooperate替代

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
targetNetworkId	string	是	键鼠穿越目标设备描述符。
inputDeviceId	number	是	待穿越输入设备标识符。
callback	AsyncCallback<void>	是	回调函数，键鼠穿越启动成功时，err为undefined，否则为错误对象。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
20900001	Service exception. Possible causes: 1. A system error, such as null pointer, container-related exception, or IPC exception. 2. N-API invocation exception or invalid N-API status.
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

import { BusinessError } from '@ohos.base';
let targetNetworkId = "networkId";
let inputDeviceId = 0;
try {
  cooperate.activate(targetNetworkId, inputDeviceId, (error: BusinessError) => {
    if (error) {
      console.log(`Start Keyboard mouse crossing failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
      return;
    }
    console.log(`Start Keyboard mouse crossing success.`);
  });
} catch (error) {
  console.log(`Start Keyboard mouse crossing failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

cooperate.activate^(deprecated)

activate(targetNetworkId: string, inputDeviceId: number): Promise<void>;

启动键鼠穿越，使用Promise异步回调。

说明：

从API version 10开始不在维护。建议使用cooperate.activateCooperate替代

系统能力: SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
targetNetworkId	string	是	键鼠穿越目标设备描述符。
inputDeviceId	number	是	待穿越输入设备标识符。

返回值：

参数名	说明
Promise<void>	无返回结果的Promise对象。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
20900001	Service exception. Possible causes: 1. A system error, such as null pointer, container-related exception, or IPC exception. 2. N-API invocation exception or invalid N-API status.
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

import { BusinessError } from '@ohos.base';
let targetNetworkId = "networkId";
let inputDeviceId = 0;
try {
 cooperate.activate(targetNetworkId, inputDeviceId).then(() => {
    console.log(`Start Keyboard mouse crossing success.`);
  }, (error: BusinessError) => {
    console.log(`Start Keyboard mouse crossing failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
  });
} catch (error) {
  console.log(`Start Keyboard mouse crossing failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

cooperate.deactivate^(deprecated)

deactivate(isUnchained: boolean, callback: AsyncCallback<void>): void;

停止键鼠穿越，使用Callback异步回调。

说明：

从API version 10开始不在维护。建议使用cooperate.deactivateCooperate替代

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
isUnchained	boolean	是	是否关闭跨设备链路。 ture表示关闭跨设备链路，false表示不关闭。
callback	AsyncCallback<void>	是	回调函数，键鼠穿越停止成功时，err为undefined，否则为错误对象。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

import { BusinessError } from '@ohos.base';
try {
  cooperate.deactivate(false, (error: BusinessError) => {
    if (error) {
      console.log(`Stop Keyboard mouse crossing failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
      return;
    }
    console.log(`Stop Keyboard mouse crossing success.`);
  });
} catch (error) {
  console.log(`Stop Keyboard mouse crossing failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

cooperate.deactivate^(deprecated)

deactivate(isUnchained: boolean): Promise<void>;

停止键鼠穿越，使用Promise异步回调。

说明：

从API version 10开始不在维护。建议使用cooperate.deactivateCooperate替代

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
isUnchained	boolean	是	是否关闭跨设备链路。 ture表示关闭跨设备链路，false表示不关闭。

返回值：

参数名	说明
Promise<void>	无返回结果的Promise对象。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
202	Not system application.

示例：

import { BusinessError } from '@ohos.base';
try {
  cooperate.deactivate(false).then(() => {
    console.log(`Stop Keyboard mouse crossing success.`);
  }, (error: BusinessError) => {
    console.log(`Stop Keyboard mouse crossing failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
  });
} catch (error) {
  console.log(`Stop Keyboard mouse crossing failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

cooperate.getCrossingSwitchState^(deprecated)

getCrossingSwitchState(networkId: string, callback: AsyncCallback<boolean>): void;

获取目标设备键鼠穿越开关的状态，使用Callback异步回调。

说明：

从API version 10开始不在维护。建议使用cooperate.getCooperateSwitchState替代

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
networkId	string	是	键鼠穿越目标设备描述符。
callback	AsyncCallback<boolean>	是	回调函数，返回ture表示目标设备键鼠穿越的开关开启，返回false表示开关未开启。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

import { BusinessError } from '@ohos.base';
let deviceDescriptor = "networkId";
try {
  cooperate.getCrossingSwitchState(deviceDescriptor, (error: BusinessError, data: boolean) => {
    if (error) {
      console.log(`Get the status failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
      return;
    }
    console.log(`Get the status success, data: ${JSON.stringify(data)}`);
  });
} catch (error) {
  console.log(`Get the status failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

cooperate.getCrossingSwitchState^(deprecated)

getCrossingSwitchState(networkId: string): Promise<boolean>;

获取目标设备键鼠穿越开关的状态，使用Promise异步方式返回结果。

说明：

从API version 10开始不在维护。建议使用cooperate.getCooperateSwitchState替代

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
networkId	string	是	键鼠穿越目标设备描述符。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

返回值：

参数	说明
Promise<boolean>	Promise对象，返回ture表示目标设备键鼠穿越的开关开启，返回false表示开关未开启。

示例：

import { BusinessError } from '@ohos.base';
let deviceDescriptor = "networkId";
try {
  cooperate.getCrossingSwitchState(deviceDescriptor).then((data: boolean) => {
    console.log(`Get the status success, data: ${JSON.stringify(data)}`);
  }, (error: BusinessError) => {
    console.log(`Get the status failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
  });
} catch (error) {
  console.log(`Get the status failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

on(‘cooperate’)^(deprecated)

on(type: ‘cooperate’, callback: Callback<{ networkId: string, msg: CooperateMsg }>): void;

注册监听键鼠穿越状态。

说明：

从API version 10开始不在维护。建议使用on(‘cooperateMessage’)替代

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
type	string	是	监听类型，取值为’cooperate’
callback	Callback<{ networkId: string, msg: CooperateMsg }>	是	回调函数，异步返回键鼠穿越状态消息。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

function callback(networkId: string, msg: cooperate.CooperateMsg) {
  console.log(`Keyboard mouse crossing event: ${JSON.stringify(networkId)}`);
  return false;
}
try {
  cooperate.on('cooperate', callback);
} catch (error) {
  console.log(`Register failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

off(‘cooperate’)^(deprecated)

off(type: ‘cooperate’, callback?: Callback<void>): void;

取消监听键鼠穿越状态。

说明：

从API version 10开始不在维护。建议使用off(‘cooperateMessage’)替代

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

参数：

参数名	类型	必填	说明
type	string	是	监听类型，取值为’cooperate’。
callback	AsyncCallback<void>	否	需要取消注册的回调函数，若无此参数，则取消当前应用注册的所有回调函数。

错误码：

以下错误码的详细介绍请参见ohos.devicestatus错误码。

错误码ID	错误信息
202	Not system application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

// 取消注册单个回调函数
function callbackOn(networkId: string, msg: cooperate.CooperateMsg) {
  console.log(`Keyboard mouse crossing event: ${JSON.stringify(networkId)}`);
  return false;
}
function callbackOff() {
  console.log(`Keyboard mouse crossing event`);
  return false;
}
try {
  cooperate.on('cooperate', callbackOn);
  cooperate.off('cooperate', callbackOff);
} catch (error) {
  console.log(`Execute failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

// 取消注册所有回调函数
function callbackOn(networkId: string, msg: cooperate.CooperateMsg) {
  console.log(`Keyboard mouse crossing event: ${JSON.stringify(networkId)}`);
  return false;
}
try {
  cooperate.on('cooperate', callbackOn);
  cooperate.off('cooperate');
} catch (error) {
  console.log(`Execute failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

CooperateMsg^(deprecated)

键鼠穿越的消息通知。

说明：

从API version 10开始不在维护。建议使用CooperateMessage替代

系统能力：SystemCapability.Msdp.DeviceStatus.Cooperate

名称	值	说明
COOPERATE_PREPARE	0	表示准备键鼠穿越。
COOPERATE_UNPREPARE	1	表示取消键鼠穿越准备。
COOPERATE_ACTIVATE	2	表示启动键鼠穿越。
COOPERATE_ACTIVATE_SUCCESS	3	表示键鼠穿越启动成功。
COOPERATE_ACTIVATE_FAIL	4	表示键鼠穿越启动失败。
COOPERATE_DEACTIVATE_SUCCESS	5	表示键鼠穿越停止成功。
COOPERATE_DEACTIVATE_FAIL	6	表示键鼠穿越停止失败。
COOPERATE_SESSION_DISCONNECTED	7	表示键鼠穿越会话断开。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Distributed Service Kit（分布式管理服务）

harmony 鸿蒙DeviceManager

harmony 鸿蒙oh_device_manager_err_code.h

harmony 鸿蒙oh_device_manager.h

harmony 鸿蒙设备管理错误码

harmony 鸿蒙键鼠穿越管理错误码

harmony 鸿蒙增强连接错误码

harmony 鸿蒙@ohos.distributedHardware.deviceManager (设备管理)(系统接口)

harmony 鸿蒙@ohos.distributedsched.abilityConnectionManager (应用多端协同管理)(系统接口)

harmony 鸿蒙@ohos.distributedsched.abilityConnectionManager (应用多端协同管理)

0 赞

所属分类： 后端技术
本文标签：
版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/p8NSo1

harmony 鸿蒙@ohos.cooperate (键鼠穿越)（系统接口）

@ohos.cooperate (键鼠穿越)（系统接口）

导入模块

cooperate.prepareCooperate11+

cooperate.prepareCooperate11+

cooperate.unprepareCooperate11+

cooperate.unprepareCooperate11+

cooperate.activateCooperate11+

cooperate.activateCooperate11+

cooperate.deactivateCooperate11+

cooperate.deactivateCooperate11+

cooperate.getCooperateSwitchState11+

cooperate.getCooperateSwitchState11+

on(‘cooperateMessage’)11+

off(‘cooperateMessage’)11+

on(‘cooperateMouse’)12+

off(‘cooperateMouse’)12+

cooperate.activateCooperateWithOptions20+

CooperateMessage11+

MouseLocation12+

CooperateState11+

MouseLocation12+

CooperateOptions20+

cooperate.prepare(deprecated)

cooperate.prepare(deprecated)

cooperate.unprepare(deprecated)

cooperate.unprepare(deprecated)

cooperate.activate(deprecated)

cooperate.activate(deprecated)

cooperate.deactivate(deprecated)

cooperate.deactivate(deprecated)

cooperate.getCrossingSwitchState(deprecated)

cooperate.getCrossingSwitchState(deprecated)

on(‘cooperate’)(deprecated)

off(‘cooperate’)(deprecated)

CooperateMsg(deprecated)

你可能感兴趣的鸿蒙文章

热门推荐

标签云

最新文章

本文目录

cooperate.prepareCooperate¹¹⁺

cooperate.prepareCooperate¹¹⁺

cooperate.unprepareCooperate¹¹⁺

cooperate.unprepareCooperate¹¹⁺

cooperate.activateCooperate¹¹⁺

cooperate.activateCooperate¹¹⁺

cooperate.deactivateCooperate¹¹⁺

cooperate.deactivateCooperate¹¹⁺

cooperate.getCooperateSwitchState¹¹⁺

cooperate.getCooperateSwitchState¹¹⁺

on(‘cooperateMessage’)¹¹⁺

off(‘cooperateMessage’)¹¹⁺

on(‘cooperateMouse’)¹²⁺

off(‘cooperateMouse’)¹²⁺

cooperate.activateCooperateWithOptions²⁰⁺

CooperateMessage¹¹⁺

MouseLocation¹²⁺

CooperateState¹¹⁺

MouseLocation¹²⁺

CooperateOptions²⁰⁺

cooperate.prepare^(deprecated)

cooperate.prepare^(deprecated)

cooperate.unprepare^(deprecated)

cooperate.unprepare^(deprecated)

cooperate.activate^(deprecated)

cooperate.activate^(deprecated)

cooperate.deactivate^(deprecated)

cooperate.deactivate^(deprecated)

cooperate.getCrossingSwitchState^(deprecated)

cooperate.getCrossingSwitchState^(deprecated)

on(‘cooperate’)^(deprecated)

off(‘cooperate’)^(deprecated)

CooperateMsg^(deprecated)