智能穿戴应用开发

产品硬件说明

屏幕规格信息

智能穿戴设备屏幕不支持旋转，屏幕旋转角度为0°，屏幕方向为竖屏。下表以WATCH 5和超新星 X1 Pro产品为例，展示产品的屏幕规格信息。

相机硬件信息

部分智能穿戴设备（如儿童智能表超新星 X系列产品）配置前置和后置摄像头，在进行摄像头相关开发时需要关注镜头安装角度和预览流旋转角度。相关定义可参考相机镜头安装角度和预览旋转角度。镜头参数可参考下表。

创新与体验提升

旋转表冠交互

智能穿戴的表冠（上键）支持按压与旋转两种交互方式，其旋转操作可触发实时交互响应。系统通过onDigitalCrown()回调函数处理表冠旋转事件，并已为常用组件内置了表冠交互支持。

主要特性：

• 事件响应：旋转操作实时触发onDigitalCrown回调。
  收起

  自动换行

  深色代码主题

  复制

  Text(this.count.toString())
    // ...
    .onDigitalCrown((event: CrownEvent) => {
      event.stopPropagation();
      this.count += event.degree;
    })

  DigitalCrownEvent.ets
• 系统集成：滚动条等组件自动响应表冠旋转方向。

默认支持表冠交互的组件包括：

• 滑动选择类：Slider、Scroll、ArcSwiper、Refresh。
• 列表展示类：List、Grid、WaterFlow、ArcList。
• 时间日期类：DatePicker、TimePicker。
• 文本选择类：TextPicker。

开发者可通过开放接口自定义表冠事件处理逻辑，实现更丰富的交互体验。关于智能穿戴表冠旋转事件的开发，可以参考表冠事件。

智慧手势

智慧手势是智能穿戴设备除屏幕交互、表冠交互和按键交互外的独特感知交互方式。在情景障碍，需要单手处理的场景，用户可以使用敲击手指和滑动指关节实现控制和切换选择诉求。

交互场景

• 提醒场景，需及时处理的控制，如电话、闹钟等。
• 高频使用场景的便捷操控，如播控中心“下一首”。
• 不方便双手点击操作的场景，如遥控拍照。

手势类型

• 捏合确认：拇指和食指快速触碰两下，表示确认当前焦点的操作。常用于确认键、音乐暂停/播放等场景。

实现原理：系统识别手势后，会触发组件的onKeyEvent事件，KeyCode为KEYCODE_ENTER，type为KeyType.Down，应用可以在该条件触发后进行功能执行，如暂停音乐。

示例代码：

.onKeyEvent((event: KeyEvent) => {
  if (event.keyCode === KeyCode.KEYCODE_ENTER && event.type === KeyType.Down) {
    // Trigger the pinching gesture
    this.oneButton1Color = '#ffe3ba51';
    this.oneButton1Text = 'Confirm';
  }
})

• 滑动切焦：切换当前焦点，以确认下一步操作，通过将拇指沿食指第二关节向指尖快速滑动两下切换焦点，后续再进行确认操作，可以用于切换到取消按钮，或切换到播放下一首按钮上，用于取消消息、切换歌曲等操作场景。

实现原理：系统识别手势后，会分别触发失焦组件和获焦组件的onBlur和onFocus事件，应用可以在该条件触发后进行功能执行，如更改获焦组件的样式为高亮展示。

示例代码：

.onFocus(() => {
  this.oneButton1Color = '#ff57c853';
  this.oneButton1Text = 'Hover';
  this.oneButton2Text = 'Two';
})
.onBlur(() => {
  this.oneButton1Color = '';
  this.oneButton1Text = 'One';
})

智慧手势交互的前提是组件获焦。首先使用activate激活当前界面的焦点激活态。

this.getUIContext().getFocusController().activate(true, false);

激活焦点激活态后，可调用requestFocus()方法使目标组件获得焦点，随后手势操作方可生效。示例代码如下，页面渲染后默认使得id为"btn1"的按钮获焦：

// register a button to get focus by default.
this.getUIContext().getFocusController().requestFocus('btn1');

退出页面时，设置当前界面的焦点激活态为false，退出焦点激活态。

aboutToDisappear(): void {
  this.getUIContext().getFocusController().activate(false);
}

功耗管理优化

为提升智能穿戴设备续航能力并给用户带来更持久、更流畅的使用体验，可以采取以下措施：

• 显示优化配置
  1. 默认启用深色主题模式降低显示能耗。

     

  2. 仅允许视频、游戏、导航等必要场景保持屏幕常亮。
• 后台应用管理
  1. 关键服务类应用（闹钟、日程提醒、邮件、IM类应用）可依据实际需求启动。
  2. 除被前台应用拉起的情况外，闹钟、日程提醒、邮件、IM类应用按需自启，禁止非必要应用以任何形式自启动。
• 定位服务规范
  1. 后台GPS仅对导航、运动健康等核心功能开放。
  2. 严禁非用户交互场景在后台调用定位服务。

若应用涉及导航、视频等需要保持应用常亮的场景，可以根据如下步骤实现：

1. 设定应用屏幕常亮首先需要在EntryAbility通过window.getLastWindow接口获取window实例。
   收起

   自动换行

   深色代码主题

   复制

   onWindowStageCreate(windowStage: window.WindowStage): void {
     let windowClass: window.Window | undefined = undefined;
     window.getLastWindow(this.context, (err: BusinessError, data: window.Window) => {
       const errCode: number = err.code;
       if (errCode) {
         hilog.error(0x0000, TAG, 'Failed to obtain the top window. Cause: ' + JSON.stringify(err));
         return;
       }
       windowClass = data;
       hilog.info(0x0000, TAG, 'Succeeded in obtaining the top window. Data: ' + JSON.stringify(data));
       AppStorage.setOrCreate('windowClass', windowClass);
     });
     // ...
   }

   WearableAbility.ets

2. 调用window的setWindowKeepScreenOn()接口，设置isKeepScreenOn参数为true使屏幕常亮。
   收起

   自动换行

   深色代码主题

   复制

   // Window object obtained from EntryAbility, which is used to ensure that the screen is steady on during navigation.
   @StorageLink('windowClass') windowClass: window.Window | undefined = undefined;
   // ...
   
   aboutToAppear(): void {
     // ...
     if (this.windowClass) {
       this.windowClass.setWindowKeepScreenOn(true, (err: BusinessError) => {
         const errCode: number = err.code;
         if (errCode) {
           hilog.error(0x0000, TAG,
             `Failed to set the screen to be always on. Cause code: ${err.code}, message: ${err.message}`);
           return;
         }
         hilog.info(0x0000, TAG, 'Succeeded in setting the screen to be always on.');
       });
     }
   }

   NavigationPageView.ets

3. 若要关闭屏幕常亮，调用setWindowKeepScreenOn()接口，设置isKeepScreenOn参数为false即可。

跨设备互通

手机与智能穿戴设备的互联通信是智能穿戴设备的核心开发场景，开发者可通过WearEngine提供的标准化接口实现跨设备交互，具体开发流程如下：

1. 通过wearEngine.getDeviceClient()获取Device模块的客户端用于获取连接设备。
   收起

   自动换行

   深色代码主题

   复制

   export class ConnectUtil {
     // Peer communication device entity class object
     device?: wearEngine.Device;
     // Unique ID of the peer communication device.
     deviceRandomId?: string;
     // Used to obtain linked devices
     deviceClient?: wearEngine.DeviceClient;
     // ...
   
     constructor(context: Context) {
       if (canIUse('SystemCapability.Health.WearEngine')) {
         this.deviceClient = wearEngine.getDeviceClient(context);
         // ...
       }
     }
     // ...
   }

   ConnectUtil.ets

2. 通过Device客户端获取当前已连接且支持wearEngine能力集的设备。
   收起

   自动换行

   深色代码主题

   复制

   // Obtains the information about the peer device connected to the peer device
   // and listens on the communication between the peer device and the peer device.
   async getConnectedDevices(): Promise<void> {
     try {
       if (canIUse('SystemCapability.Health.WearEngine')) {
         let devices: wearEngine.Device[] = await this.deviceClient?.getConnectedDevices() as wearEngine.Device[];
         this.device = devices[0];
         this.deviceRandomId = devices[0].randomId;
       }
       await this.registerMessageReceiver();
     } catch (err) {
       hilog.error(0x0000, TAG, 'getConnectedDevices is err' + JSON.stringify(err));
     }
   }

   ConnectUtil.ets

3. 通过获取P2P模块的客户端用于互联通信。
   收起

   自动换行

   深色代码主题

   复制

   export class ConnectUtil {
     // ...
     // Used to p2p
     p2pClient?: wearEngine.P2pClient;
     // ...
   
     constructor(context: Context) {
       if (canIUse('SystemCapability.Health.WearEngine')) {
         // ...
         this.p2pClient = wearEngine.getP2pClient(context);
       }
     }
     // ...
   }

   ConnectUtil.ets

4. 订阅对端设备应用向本侧发送消息的事件。
   收起

   自动换行

   深色代码主题

   复制

   // Callback Method for Listening to Peer Communication.
   private onMsgCallback: Callback<wearEngine.P2pMessage> = (data: wearEngine.P2pMessage): void => {
     // Decodes the intercepted content into a character string.
     let decoder: util.TextDecoder = util.TextDecoder.create();
     if (canIUse('SystemCapability.Health.WearEngine')) {
       let str: string = decoder.decodeToString(data.content);
       promptAction.openToast({
         message: 'message: ' + str,
         duration: 2000
       });
     }
   }
   
   // Listening to the communication between the peer end.
   async registerMessageReceiver(): Promise<void> {
     try {
       if (canIUse('SystemCapability.Health.WearEngine')) {
         await this.p2pClient?.registerMessageReceiver(this.deviceRandomId, appParam, this.onMsgCallback);
         hilog.info(0x0000, TAG, 'registerMessageReceiver is ok');
       }
     } catch (err) {
       hilog.error(0x0000, TAG, 'registerMessageReceiver is err ', JSON.stringify(err));
     }
   }
   
   // Disabling the Interception of Peer Communication。
   async unregisterMessageReceiver(): Promise<void> {
     try {
       if (canIUse('SystemCapability.Health.WearEngine')) {
         await this.p2pClient?.unregisterMessageReceiver(this.deviceRandomId, appParam, this.onMsgCallback);
         hilog.info(0x0000, TAG, 'unregisterMessageReceiver is ok');
       }
     } catch (err) {
       hilog.error(0x0000, TAG, 'unregisterMessageReceiver is err ', JSON.stringify(err));
     }
   }

   ConnectUtil.ets

5. 向对端设备发送消息。
   收起

   自动换行

   深色代码主题

   复制

   // Method of sending messages to the peer end
   async sendMessage(message: string): Promise<void> {
     try {
       let p2pMessage: wearEngine.P2pMessage = this.getP2pMessage(message);
       if (canIUse('SystemCapability.Health.WearEngine')) {
         let value = await this.p2pClient?.sendMessage(this.deviceRandomId, appParam, p2pMessage);
         hilog.info(0x0000, TAG, 'sendMessage value is' + JSON.stringify(value))
       }
     } catch (err) {
       hilog.error(0x0000, TAG, 'sys sendMessage is err ' + JSON.stringify(err));
     }
   }

   ConnectUtil.ets

消息通知

智能穿戴设备的消息通知来源包括：

• 手机应用通知：应用通过华为运动健康授权消息通知权限后，配对手机的应用通知将同步至穿戴设备。
• 手机主动推送：手机应用使用WearEngine接口直接向穿戴设备发送消息通知。
• 穿戴设备本地通知：手表应用通过Notification Kit自主发送通知。

手机应用通知

在华为运动健康APP中，进入消息通知设置界面，为指定手机应用开启通知权限，即可将该应用的消息实时同步至已配对的华为智能穿戴设备。

手机主动推送

手机应用可以通过WearEngine的notify()实现手机向智能穿戴设备主动推送消息通知，开发步骤如下：

1. 通过wearEngine.getNotifyClient()获取Notify客户端类。
   收起

   自动换行

   深色代码主题

   复制

   // Used to notify message
   notifyClient: wearEngine.NotifyClient | undefined;

   CommunicationUtils.ets

   使用当前组件所在Ability的Context，获取Notify模块的客户端。

   收起

   自动换行

   深色代码主题

   复制

   try {
     this.connectUtils.notifyClient = wearEngine.getNotifyClient(this.getUIContext().getHostContext());
   } catch (err) {
     hilog.error(0x0000, TAG,
       `Failed to get notify client. Cause code: ${err.code}, message: ${err.message}`);
   }

   Index.ets

2. 通过NotifyClient.notify()实现手机向智能穿戴设备发送模板化通知。
   收起

   自动换行

   深色代码主题

   复制

   /*
    * Method of notifying a message to watch.
    */
   notifyMessage() {
     // Configure the notification content.
     // Including the package name of the notification source, notification title, and notification content.
     let type1Notification: wearEngine.Notification = {
       type: wearEngine.NotificationType.NOTIFICATION_WITHOUT_BUTTONS,
       bundleName: 'com.example.smartwatchmapnavigation',
       title: 'smartwatchmapnavigation',
       text: 'walk navigation start',
     }
     let options: wearEngine.NotificationOptions = {
       notification: type1Notification,
       onAction: (feedback: wearEngine.NotificationFeedback) => {
         hilog.info(0x000, TAG,
           `one button notify get feedback is ${feedback.action ? feedback.action : feedback.errorCode}`);
       }
     }
   
     // Sends a notification to the watch based on notifyClient.
     // This method can be invoked only by apps on mobile phones.
     this.notifyClient!.notify(this.deviceRandomId, options).then(result => {
       hilog.info(0x000, TAG, `Succeeded in sending notification.`);
     }).catch((error: BusinessError) => {
       hilog.error(0x000, TAG, `Failed to send notification. Code is ${error.code}, message is ${error.message}`);
     })
   }

   CommunicationUtils.ets

智能穿戴设备本地通知

智能穿戴设备应用可以通过NotificationManager模块实现自主发送通知。

1. 请求通知授权。

   可通过requestEnableNotification的错误码判断用户是否授权。若返回的错误码为1600004，即为拒绝授权。

   收起

   自动换行

   深色代码主题

   复制

   aboutToAppear() {
     let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
     notificationManager.isNotificationEnabled().then((data: boolean) => {
       hilog.info(DOMAIN_NUMBER, TAG, "isNotificationEnabled success, data: " + JSON.stringify(data));
       if (!data) {
         notificationManager.requestEnableNotification(context).then(() => {
           hilog.info(DOMAIN_NUMBER, TAG, `[ANS] requestEnableNotification success`);
         }).catch((err: BusinessError) => {
           if (1600004 == err.code) {
             hilog.error(DOMAIN_NUMBER, TAG,
               `[ANS] requestEnableNotification refused, code is ${err.code}, message is ${err.message}`);
           } else {
             hilog.error(DOMAIN_NUMBER, TAG,
               `[ANS] requestEnableNotification failed, code is ${err.code}, message is ${err.message}`);
           }
         });
       }
     }).catch((err: BusinessError) => {
       hilog.error(DOMAIN_NUMBER, TAG, `isNotificationEnabled fail, code is ${err.code}, message is ${err.message}`);
     });
   }

   NotifyPage.ets

2. 构造NotificationRequest对象，并发布通知。
   收起

   自动换行

   深色代码主题

   复制

   Button('发送通知')
     .onClick(()=>{
       let notificationRequest: notificationManager.NotificationRequest = {
         id: 1,
         content: {
           // General text type notification.
           notificationContentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
           normal: {
             title: 'test_title',
             text: 'test_text',
             additionalText: 'test_additionalText',
           }
         }
       };
       notificationManager.publish(notificationRequest, (err: BusinessError) => {
         if (err) {
           hilog.error(DOMAIN_NUMBER, TAG, `Failed to publish notification. Code is ${err.code}, message is ${err.message}`);
           return;
         }
         hilog.info(DOMAIN_NUMBER, TAG, 'Succeeded in publishing notification.');
       });
     })

   NotifyPage.ets

未成年人模式适配

智能穿戴设备中的儿童智能表应用面向儿童用户，启蒙教育、内容展示、社交互动、音视频、游戏等应用应重点评估未成年人保护要求。应用如需跟随系统未成年人模式调整内容展示、功能入口或使用时长，应适配未成年人模式能力。

未成年人模式相关能力可参考Account Kit（华为账号服务）中的minorsProtection能力。开发者应根据应用场景判断是否需要获取未成年人模式开启状态、年龄段信息，或引导用户开启未成年人模式。

适配设备常见问题

工程调试

智能穿戴设备上如何进行工程调试

问题描述：拿到智能穿戴设备后，不知如何将应用部署到智能穿戴设备上调试应用功能。

解决方案：智能穿戴使用WIFI无线调试（支持自动签名），调试规范如下：

1. 调试模式：智能穿戴设备推荐使用WiFi无线调试（支持自动签名）。无线调试内容可参考使用无线连接方式。
2. 调试稳定性：设备熄屏后WiFi调试连接会断开，建议在系统设置中延长自动熄屏时间，确保调试过程稳定。
3. 设备授权：首次调试时，手表将弹出“信任设备”提示，需点击“信任”以允许IDE连接。

工程配置

智能穿戴设备上如何进行工程配置

问题描述：不知道智能穿戴设备需要完成哪些工程配置，成人智能表和儿童智能表的工程配置有哪些不同。

解决方案：开发在智能穿戴设备上的应用，需要在module.json5配置文件的module字段中，为deviceTypes字段设置wearable类型。更多详情可参考deviceTypes标签。若当前已有适配轻量级智能表的工程，需要迁移适配成人智能表设备，可以参考FA工程迁移。

成人智能表应用完成以上配置即可，儿童智能表应用需要额外添加儿童智能表分发策略配置，DevEco Studio需更新至6.1.0 Release及以上，具体步骤如下：

1. 在resources/base/profile目录下新增distributionFilter_config.json，配置方形屏和屏幕尺寸，文件内容如下：
   收起

   自动换行

   深色代码主题

   复制

   {
     "distributionFilter": {
       "screenShape": {
         "policy": "include",
         "value": [
           "rect"
         ]
       },
       "screenWindow": {
         "policy": "include",
         "value": [
           "480*408"
         ]
       }
     }
   }

2. 在module.json5中关联该分发策略文件，并声明儿童智能表设备特征。以下为配置片段，开发者需按实际工程结构合入module字段：
   收起

   自动换行

   深色代码主题

   复制

   {
     "module": {
       "deviceTypes": [
         "wearable"
       ],
       "metadata": [
         {
           "name": "string",
           "value": "string",
           "resource": "$profile:distributionFilter_config"
         }
       ],
       "requiredDeviceFeatures": {
         "wearable": [
           "child"
         ]
       }
     }
   }

3. 儿童智能表应用项目的API版本不低于API 23，需要修改工程级build-profile.json5文件的相关字段：
   收起

   自动换行

   深色代码主题

   复制

   {
     "targetSdkVersion": "6.1.0(23)",
     "compatibleSdkVersion": "6.1.0(23)"
   }