目录

电脑应用开发

概述

电脑设备在日常生活中发挥重要作用,是HarmonyOS 1+8设备全场景一体化体验中不可或缺的部分。

电脑设备包含笔记本和台式机两种形态,有以下明显特点:

当前电脑产品主要为MateBook Pro系列、MateBook Pro S系列和擎云HM650系列。

产品名称 示意图
MateBook Pro系列
MateBook Pro S系列
擎云HM650系列

本文聚焦于电脑应用的体验提升开发指导。如需多设备开发的基础通用能力指导,请参考“一次开发,多端部署概览”系列文章。

产品硬件信息

本章将介绍电脑的屏幕尺寸以及相机硬件参数等信息。

[h2]屏幕规格信息

以MateBook Pro设备为例,其效果图、分辨率以及横纵断点等参数如下表所示:

MateBook Pro(笔记本形态) 外接显示器
效果图
屏幕ID 0

主显示器:0

外接显示器:与连接的MateBook Pro端口有关

屏幕方向(Orientation) 横屏LANDSCAPE NA
分辨率(px) 3120*2080

主显示器:3120*2080

外接显示器:取决于外接显示器的分辨率

分辨率(vp)(向下取整) 1642*1094

主显示器:1642*1094

外接显示器:取决于外接显示器的分辨率

屏幕可用宽高(px) 3120*1955

主显示器:3120*1955

外接显示器:取决于外接显示器的分辨率

屏幕可用宽高(vp)(向下取整) 1642*1028

主显示器:1642*1028

外接显示器:取决于外接显示器的分辨率

横纵断点 横向断点xl,纵向断点sm

主显示器:横向断点xl,纵向断点sm

外接显示器:取决于外接显示器的分辨率

  • 台式机无内置屏幕,需外接显示器作为显示输出;笔记本也可外接显示器扩展显示。
  • 台式机外接显示器(以擎云HM650系列为例)可支持的分辨率范围为1024*768<=分辨率<=3840*2160,DPI范围为136<=DPI<=400。

[h2]相机硬件信息

电脑的相机预设了默认的相机镜头安装角度。使用时,需考虑镜头角度与设备的旋转角度,具体定义可参考预览旋转角度。当前电脑的摄像头不支持旋转。

对于MateBook Pro等仅搭载前置摄像头的电脑设备,其相机镜头安装角度及预览流旋转角度如下:

屏幕旋转角度(rotation) 0(0度) 1(90度) 2(180度) 3(270度)
示意图 NA NA NA
前置相机镜头安装角度 0° NA NA NA
前置相机预览旋转角度 0°+0°=0° NA NA NA

部分电脑产品(如MateBook Pro S),同时搭载了前置摄像头和后置摄像头,其相机镜头安装角度和需要设置的预览流旋转角度如下:

屏幕旋转角度(rotation) 0(0度) 1(90度) 2(180度) 3(270度)
示意图 NA NA NA
前置相机镜头安装角度 0° NA NA NA
前置相机预览旋转角度 0°+0°=0° NA NA NA
后置相机镜头安装角度 0° NA NA NA
后置相机预览旋转角度 0°+0°=0° NA NA NA
  • 台式机默认无内置摄像头。

创新与体验提升

[h2]性能优化

电脑应用的性能优化,直接关系到用户体验、运行效率和硬件资源利用率。HarmonyOS为开发者提供DevEco Profiler工具,可实现全维度性能监控(CPU/GPU/内存/帧率/能耗/网络等),并支持代码级问题定位分析,协助开发者快速发现并优化性能瓶颈。性能工具使用指导可参考性能调优工具简介,性能场景优化案例可参考性能场景优化案例。

对于电脑中的关键线程,可以通过提升任务调度优先级,确保其获得充足的连续执行时长和资源,从而保障应用流畅运行,优化用户体验。详情可参考高负载场景线程优先级设置。

[h2]焦点导航

电脑设备自带键盘,应用应支持通过键盘实现焦点导航,并配置获焦视觉效果,清晰指示当前焦点位置,以保证交互体验。开发方案请参考焦点事件。

[h2]音频焦点适配

电脑上前后台应用需从以下四个方面处理音频焦点问题:音频焦点抢占流程,音频流类型正确配置,自定义焦点策略设置,焦点中断事件正确处理。

电脑设备场景下的管理机制与其他设备相通,主要区别在于系统默认策略不一样,开发者可参考自定义焦点策略设置查看电脑与其他设备间的差异。

[h2]悬浮窗

悬浮窗口在电脑端是一种特殊的应用窗口,其窗口类型为WindowType.TYPE_FLOAT。开发者可在现有任务基础上创建悬浮窗,使其常驻前台、置于所有应用窗口顶层展示;即便创建悬浮窗的应用退至后台,悬浮窗仍可保持前台显示。开发者可参考全局悬浮窗开发指导相关章节,完成悬浮窗创建及属性配置等操作。

[h2]手写笔适配

以MateBook Pro S系列产品为例,设备支持手写笔功能,可通过触控屏、触控板实现单击、双击、长按、拖拽等交互操作,应用可根据这些操作进行功能适配,详情可参考多设备交互。

手写笔支持无感连接与低延迟传输,开盒即用,适用于全局批注、提笔速记及按键遥控等功能场景,实现流畅自然的书写与交互体验。HarmonyOS提供的Pen Kit(参考Pen Kit简介)能力,可助力开发者灵活接入手写套件、全局取色、一笔成形等接口,提升书写交互的扩展性与创作效率。

兼容模式

本节介绍电脑端兼容模式的运行规则、上架配置、调试方式,以及相机、接口、文件访问、硬件能力等多方面的适配要点。

[h2]兼容运行

兼容运行是HarmonyOS为开发者提供的在电脑设备上直接运行手机/平板应用的方式。

兼容运行在电脑设备的窗口模式

手机/平板应用以兼容模式在电脑端运行时,窗口默认显示规则如下:

兼容应用不支持进入最大化。

窗口模式的白名单策略

操作系统中预置了白名单功能,用于管控应用默认显示比例,包括18:9、1:1和全屏铺满。

[h2]兼容运行工程配置

已适配手机/平板的应用在电脑上兼容运行时,需在应用Entry Module的module.json5中移除对2in1设备的支持:

"deviceTypes": [
    "default",
    "tablet",
    "2in1"(去除)
]

Entry Module所依赖的module同名配置文件也需要同步修改。

[h2]应用兼容性测试

生态发展初期,开发者主要通过兼容模式上架电脑端应用;随着生态逐步成熟,为便于开发者持续在电脑设备上做横屏适配,系统提供了对应设置项用于管控兼容策略。

应用安装后,可进入设置->显示和亮度->应用显示布局,将应用显示比例调整为原始比例,即可退出兼容模式,方便开发者调试。

[h2]兼容运行上架配置

应用上架时,在基本信息中勾选“兼容分发到PC/2in1的AppGallery”选项,如下图所示:

若在支持设备处选择“PC/2in1”上架,应用将不会进入兼容运行模式,系统兼容能力不会生效。

[h2]需要排查或简单适配内容

原则上,兼容运行的应用仅需针对差异点做少量适配,或无需额外适配;具体适配要求可参考下文说明逐一排查处理。

设备常见适配问题

[h2]设备类型区分

如何区分MateBook Pro和MateBook Fold

[h2]包管理策略

电脑端HAP包的管理策略需结合使用场景灵活选择,在统一性与个性化之间实现平衡,兼顾开发效率与用户体验,具体方案如下:

更多详情可参见分层架构设计的产品定制层相关内容。

[h2]窗口适配

窗口变化时,应用对可用区域变化感知不及时

问题描述:应用无法感知可用区域变化或感知存在延迟,直接调用moveWindowTo()、resize()调整窗口大小或位置,导致窗口大小或位置异常。

解决措施:使用以下三种方法均可解决该问题。

自由多窗适配电脑设备窗口异常问题

问题描述:自由多窗适配电脑设备时,可能出现以下问题:

解决措施:

窗口启动时应用闪跳

可能原因:module.json5配置文件中metadata标签设置的窗口位置、大小,与onWindowStageCreate()中布局设置的窗口参数不一致。

解决措施:保持module.json5的metadata配置与onWindowStageCreate()中窗口位置、大小参数一致。

"abilities": [
  {
    "name": "EntryAbility",
    "srcEntry": "./ets/entryability/EntryAbility.ets",
    "supportWindowMode": [
      "fullscreen"
    ],
    "metadata": [
      {
        "name": "ohos.ability.window.height",
        "value": "600"
      },
      {
        "name": "ohos.ability.window.width",
        "value": "600"
      },
      {
        "name": "ohos.ability.window.left",
        "value": "left"
      },
      {
        "name": "ohos.ability.window.top",
        "value": "top"
      }
    ],
    // ...
  },
  // ...
],
onWindowStageCreate(windowStage: window.WindowStage): void {
  // Main window is created, set main page for this ability
  hilog.info(DOMAIN, TAG, '%{public}s', 'Ability onWindowStageCreate');
  try {
    let mainWindow = windowStage.getMainWindowSync();
    let displayId = mainWindow.getWindowProperties().displayId;
    let displayClass = display.getDisplayByIdSync(displayId);
    displayClass.getAvailableArea().then(() => {
      mainWindow.resize(mainWindow.getUIContext().px2vp(600), mainWindow.getUIContext().px2vp(600))
        .catch((err: BusinessError) => {
          hilog.error(DOMAIN, TAG, '%{public}s',
            `Failed to change the window size. Code: ${err.code}, message: ${err.message}`);
        });
      mainWindow.moveWindowTo(0, 0).catch((err: BusinessError) => {
        hilog.error(DOMAIN, TAG, '%{public}s',
          `Failed to move the window. Code: ${err.code}, message: ${err.message}`);
      });
    }).catch((err: BusinessError) => {
      hilog.error(DOMAIN, TAG, '%{public}s',
        `Failed to get the available area in this display. Code: ${err.code}, message: ${err.message}`);
    })
  } catch (err) {
    hilog.error(DOMAIN, TAG, '%{public}s',
      `Failed to move the window. Cause code: ${err.code}, message: ${err.message}`);
  }
  windowStage.loadContent('pages/Index', (err) => {
    if (err.code) {
      hilog.error(DOMAIN, TAG, 'Failed to load the content. Cause: %{public}s', err);
      return;
    }
    hilog.info(DOMAIN, TAG, 'Succeeded in loading the content.');
  });
}

[h2]台式机音频输入与录音适配

问题描述:台式机默认无外接音箱与耳麦,不具备音频输入设备(麦克风),应用中的录音、语音通话、语音输入等功能无法正常使用。

解决措施:

[h2]台式机相机适配

问题描述:台式机默认无内置摄像头,涉及相机的功能(拍照、摄像、扫码等)若无相机硬件支持无法正常使用。

解决措施: