目标拍摄跟踪开发指南

接口介绍

机械体设备控制器API的接口使用指导请参见@ohos.distributedHardware.mechanicManager (机械体控制模块)。

开发步骤

开发准备

1. 支持Mechanic Kit协议的机械体设备，参考管理设备连接状态第2点。
2. 若要验证目标跟踪功能，主设备的相机驱动必须支持人脸检测。
3. 请将SDK更新到API 20或以上版本，具体操作参见更新指南。
4. 请确保机械体设备已通过蓝牙与主设备连接。

管理设备连接状态

确保机械体设备连接或断开时，应用能及时响应，支持设备连接状态的动态管理。

1. 导入机械体设备管理模块。

   import { mechanicManager } from '@kit.MechanicKit';

   ApiTestPage.ets

2. 查询设备是否支持机械体设备控制能力。

   let isSupported: boolean = mechanicManager.isControlSupported();
   console.info(`'isSupported:' ${isSupported}`);

   ApiTestPage.ets

3. 获取已连接的机械体列表。

   let savedMechanicIds: number[] = [];
   
   try {
   const devices = mechanicManager.getAttachedMechDevices();
   console.info('Connected devices:', devices);
   
   devices.forEach(device => {
       console.info(`Device ID: ${device.mechId}`);
       console.info(`Device Name: ${device.mechName}`);
       console.info(`Device Type: ${device.mechDeviceType}`);
       
   //保存设备类型为GIMBAL_DEVICE的设备的MechId
       if (device.mechDeviceType === mechanicManager.MechDeviceType.GIMBAL_DEVICE) {
       savedMechanicIds.push(device.mechId);
       console.info(`GIMBAL_TYPE device saved ID: ${device.mechId}`);
       } else {
       console.info(`Skip non-gimbal devices: ${device.mechId}`);
       }
   });
   
   console.info('List of saved gimbal device IDs:', savedMechanicIds);
   } catch (err) {
   console.error('Error getting attached devices:', err);
   }

   ApiTestPage.ets

4. 监听设备的连接状态变化，以便及时响应。

   const attachStateChangeCallback = (info: mechanicManager.AttachStateChangeInfo) => {
   if (info.state === mechanicManager.AttachState.ATTACHED) {
       console.info('Device attached:', info.mechInfo);
       // 执行设备连接的相关操作
       handleDeviceAttached(info.mechInfo);
   } else if (info.state === mechanicManager.AttachState.DETACHED) {
       console.info('Device detached:', info.mechInfo);
       // 执行设备断开的相关操作
       handleDeviceDetached(info.mechInfo);
   }
   };
   
   // 注册监听
   mechanicManager.on('attachStateChange', attachStateChangeCallback);

   AttachStateChangeCallbackRegister.ets

5. 处理设备的连接与断开的事件。

   function handleDeviceAttached(mechInfo: mechanicManager.MechInfo) {
   console.info(`New device is connected: ${mechInfo.mechName} (ID: ${mechInfo.mechId})`);
   savedMechanicIds.push(mechInfo.mechId);
   // To do sth.
   }
   
   function handleDeviceDetached(mechInfo: mechanicManager.MechInfo) {
   console.info(`Device disconnected: ${mechInfo.mechName} (ID: ${mechInfo.mechId})`);
   savedMechanicIds = savedMechanicIds.filter(id => id !== mechInfo.mechId);
   // To do sth.
   }

   AttachStateChangeCallbackRegister.ets

6. 取消连接状态的监听。

   // 取消连接状态的监听
   mechanicManager.off('attachStateChange', attachStateChangeCallback);

   AttachStateChangeCallbackRegister.ets

控制设备目标跟踪拍摄

启用目标拍摄功能后，设备将自动识别人脸并进行跟踪拍摄。

1. 启用摄像头的目标拍摄功能。

   try {
   //检查前判断savedMechIds不为空
   // 检查跟踪状态
   const isEnabled = mechanicManager.getCameraTrackingEnabled();
   
   if (isEnabled == false) {
       // 开启摄像头跟踪
       mechanicManager.setCameraTrackingEnabled(true);
       console.info('Camera tracking enabled');
   }
   
   console.info('Is tracking currently enabled:', isEnabled);
   } catch (err) {
   console.error('Failed to enable camera tracking:', err);
   }

   ApiTestPage.ets

2. 监听相机跟踪状态的变化。

   const trackingStateCallback = (eventInfo : mechanicManager.TrackingEventInfo) => {
   switch (eventInfo.event) {
       case mechanicManager.TrackingEvent.CAMERA_TRACKING_USER_ENABLED:
       console.info('The user has enabled camera tracking');
       handleTrackingEnabled();
       break;
       case mechanicManager.TrackingEvent.CAMERA_TRACKING_USER_DISABLED:
       console.info('The user has disabled camera tracking');
       handleTrackingDisabled();
       break;
       case mechanicManager.TrackingEvent.CAMERA_TRACKING_LAYOUT_CHANGED:
       console.info('Tracking layout has changed');
       handleLayoutChanged();
       break;
   }
   };
   
   // 注册跟踪状态监听
   mechanicManager.on('trackingStateChange', trackingStateCallback);

   ApiTestPage.ets

3. 处理跟踪状态变化事件。

   function handleTrackingEnabled() {
   console.info('Handling camera tracking enable events');
   // 可以在此处更新UI状态
   updateTrackingUI(true);
   }
   
   function handleTrackingDisabled() {
   console.info('Handling camera tracking disabled events');
   // 可以在此处更新UI状态
   updateTrackingUI(false);
   }
   
   function handleLayoutChanged() {
   try {
       const newLayout = mechanicManager.getCameraTrackingLayout();
       console.info('New Tracking Layout:', newLayout);
       // 根据新布局更新UI
       updateLayoutUI(newLayout);
   } catch (err) {
       console.error('Failed to get new layout:', err);
   }
   }
   
   function updateTrackingUI(enabled: boolean) {
   // 更新UI显示跟踪状态
   // To do sth.
   console.info('Update tracking UI status:', enabled);
   }
   
   function updateLayoutUI(layout : mechanicManager.CameraTrackingLayout) {
   // 更新UI显示布局状态
   // To do sth.
   console.info('Update layout UI:', layout);
   }

   ApiTestPage.ets

4. 取消跟踪状态变化的监听。

   // 取消跟踪状态监听
   mechanicManager.off('trackingStateChange', trackingStateCallback);
   
   // 或者取消所有跟踪状态监听
   mechanicManager.off('trackingStateChange');

   ApiTestPage.ets

调试验证

请按照以下步骤调试验证，确保机械体设备管理功能正常：

建立连接

1. 确保机械体与开发设备已通过蓝牙配对并连接。
2. 将开发设备放置在机械体设备上。

功能验证步骤

1. 设备列表查询：调用 getAttachedMechDevices 接口查询当前已连接的机械体设备列表，验证设备是否正确识别。
2. 目标拍摄跟踪：调用 setCameraTrackingEnabled 启用摄像头目标跟踪功能，使用 getCameraTrackingEnabled 验证状态，测试设备是否能跟随目标自动旋转。

验证结果说明

• 如果 getAttachedMechDevices 返回设备列表，表示设备识别成功。
• 如果 getCameraTrackingEnabled 返回真，目标拍摄跟踪启用成功。应用打开相机后，画面中出现人脸时，设备会跟随人脸转动。