HarmonyOS鸿蒙Next中卡片使用formBindingData.createFormBindingData(FormData)如何获取

【背景知识】

如下图，元服务卡片提供方可以使用updateForm接口更新卡片，卡片UI代码内通过LocalStorageProp可以获得卡片提供方推送的需要刷新的卡片数据，接收需要刷新的卡片数据时，卡片数据会被转换成string类型。另外卡片框架还会通过开发者声明的定时信息按需通知卡片提供方进行卡片刷新。

formProvider：提供卡片提供方相关的接口能力，可通过该模块提供接口实现更新卡片、设置卡片更新时间、获取卡片信息、请求发布卡片等。 updateForm：卡元服务片提供方调用，更新指定的卡片，使用Promise异步回调，其参数如下：

formBindingData：提供卡片数据绑定的能力，包括FormBindingData对象的创建、相关信息的描述。

【解决方案】

可参考以下方法将数据传输到元服务卡片： 导入formBindingData、formProvider等相关模块，通过createFormBindingData创建FormBindingData对象绑定数据，调用formProvider.updateForm更新表单数据，并处理Promise的成功和失败情况，示例代码如下：

private VideoPath:string='VideoPath';
onAddForm(want: Want): formBindingData.FormBindingData {
  let formId: string
  // 卡片使用方创建卡片时触发，提供方需要返回卡片数据绑定类
  let FormData: Record<string, string> = {
    'VideoPath': this.VideoPath,
  };
  if(!want || !want.parameters) {
    hilog.error(0x0000, TAG, `FormAbility onAddForm want or want.parameters is undefined`);
    return formBindingData.createFormBindingData('');
  }
  try {
    formId= want.parameters[formInfo.FormParam.IDENTITY_KEY] as string;
    let  FormData2 = formBindingData.createFormBindingData(FormData)
    formProvider.updateForm(formId, FormData2).then(() => {
      console.log(`formProvider updateForm success`);
    }).catch((error: BusinessError) => {
      console.error(`promise error, code: ${(error as BusinessError).code}, message: ${(error as BusinessError).message})`);
    });
  } catch (error) {
    console.error(`catch error, code: ${(error as BusinessError).code}, message: ${(error as BusinessError).message})`);
  }
  return formBindingData.createFormBindingData(FormData);

WidgetCard.ets

let localStorage = new LocalStorage();
@Entry(localStorage)
@Component
struct WidgetCard {
  /*
   * The title.
   */
  readonly title: string = 'Hello World';
  /*
   * The action type.
   */
  readonly actionType: string = 'router';
  /*
   * The ability name.
   */
  readonly abilityName: string = 'EntryAbility';
  /*
   * The message.
   */
  readonly message: string = 'add detail';
  /*
   * The width percentage setting.
   */
  readonly fullWidthPercent: string = '100%';
  /*
   * The height percentage setting.
   */
  readonly fullHeightPercent: string = '100%';

  @LocalStorageProp('VideoPath') formData: string = '';
  aboutToAppear(): void {
      
  }

  build() {
    Row() {
      Text(this.formData)
    }
    .height(this.fullHeightPercent)
    .backgroundColor($r('sys.color.comp_background_primary'))
  }
}