鸿蒙5.0&next开发【@ohos.mulitmodalawareness.motion (动作感知)】 硬件_ohos.multimodalawareness.motion

本模块，提供对用户行为、动作的感知能力，包括用户的手势、动作等。

说明

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

导入模块

import { motion } from \'@kit.MultimodalAwarenessKit\';

OperatingHandStatus

触控操作手状态信息。

系统能力：SystemCapability.MultimodalAwarness.Motion

名称 值 说明 UNKNOWN_STATUS 0 表示未识别。 LEFT_HAND_OPERATED 1 表示触控操作手是左手。 RIGHT_HAND_OPERATED 2 表示触控操作手是右手。

motion.on(‘operatingHandChanged’)

on(type: ‘operatingHandChanged’, callback: Callback): void;

订阅触控操作手感知事件。

需要权限：ohos.permission.ACTIVITY_MOTION

系统能力：SystemCapability.MultimodalAwarness.Motion

参数：

参数名 类型 必填 说明 type string 是 事件类型。type为“operatingHandChanged”，表示操作手状态变化。 callback Callback 是 回调函数，返回操作手状态。 错误码ID 错误信息 201 Permission denied. 401 Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. 801 Capability not supported.Function can not work correctly due to limited device capabilities. 31500001 Service exception. 31500002 Subscribe Failed.

示例：

motion.on(\'operatingHandChanged\', (data:motion.OperatingHandStatus) => { console.info(\'on success\' + data);})

motion.off(‘operatingHandChanged’)

off(type: ‘operatingHandChanged’, callback?: Callback): void;

取消订阅触控操作手感知事件。

需要权限：ohos.permission.ACTIVITY_MOTION

系统能力：SystemCapability.MultimodalAwarness.Motion

参数：

参数名 类型 必填 说明 type string 是 事件类型。type为“operatingHandChanged”，表示操作手状态变化。 callback Callback 否 回调函数，返回操作手状态。 错误码ID 错误信息 201 Permission denied. 401 Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. 801 Capability not supported.Function can not work correctly due to limited device capabilities. 31500001 Service exception. 31500003 UnSubscribe Failed.

示例：

motion.off(\'operatingHandChanged\', (data:motion.OperatingHandStatus) => { console.info(\'off success\' + data);})

motion.getRecentOperatingHandStatus()

getRecentOperatingHandStatus(): OperatingHandStatus;

获取最新触控操作手状态。

需要权限：ohos.permission.ACTIVITY_MOTION

系统能力：SystemCapability.MultimodalAwarness.Motion

返回值：

类型 说明 [OperatingHandStatus] 返回触控操作手状态信息。 错误码ID 错误信息 201 Permission denied. 801 Capability not supported.Function can not work correctly due to limited device capabilities. 31500001 Service exception.

示例：

let data:motion.OperatingHandStatus = motion.getRecentOperatingHandStatus();console.info(\'get success\' + data);