HarmonyOS鸿蒙Next卡片开发-卡片可选功能开发学习

HarmonyOS鸿蒙Next卡片开发-卡片可选功能开发学习

1. 卡片编辑功能

卡片提供方提供一个卡片的编辑页面，允许从卡片跳转至编辑页面。

卡片提供方在配置文件config.json中添加参数“formConfigAbility”，配置参数信息的规则如下。

配置该参数的值，导航到编辑页面的Page ability，

格式：ability://单个ability名

如果不配置“formConfigAbility”参数，则无卡片编辑功能。

1. 卡片背景模糊

卡片可以在config.json中声明是否支持背景模糊。声明方式如下：

config.json的metaData中，在customizeData中增加一个name为needBlurBackgroundForLauncher的字符串类型的属性, value为“true”表示支持， 否则为不支持。

"forms": [
  {
    "name": "Form_JS_DEMO",
    "description": "it is js form",
    "type": "JS",
    "jsComponentName": "card",
    "colorMode": "auto",
    "isDefault": true,
    "updateEnabled": true,
    "scheduledUpdateTime": "10:30",
    "defaultDimension": "2*2",
    "supportDimensions": [
      "2*2",
      "2*4"
    ],
    "metaData": {
      "customizeData": [
        {
          "name": "needBlurBackgroundForLauncher",
          "value": "true"
        }
      ]
    }
  }
]

卡片开发者可以从onCreateForm的回调中，获取是否支持背景模糊：

protected ProviderFormInfo onCreateForm(Intent intent) {
    ...... 
    // 1. 获取自定义数据
    IntentParams intentParams = intent.getParam(AbilitySlice.PARAM_FORM_CUSTOMIZE_KEY);
    
    // 2. 从intentParams中获取是否支持背景模糊
    boolean isSupport = (boolean) intentParams.getParam("fa_card_background_blur_support");
    ......
}

说明

背景模糊限制： 当前仅JS卡片支持背景模糊。

卡片背景模糊需要硬件支持，目前支持搭载麒麟9000或高通骁龙865及以上型号CPU的机型。使用其他机型可能无法预览到背景模糊效果。

本文主要参考官方开发文档。