diff --git a/zh-cn/application-dev/reference/apis/js-apis-formInfo.md b/zh-cn/application-dev/reference/apis/js-apis-formInfo.md index 119d7675b9a78fd454bfb52db57fd91e5bb9f353..b902cfc9933fc759e984c016d2020cbbdb63d015 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-formInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-formInfo.md @@ -102,4 +102,6 @@ import formInfo from '@ohos.application.formInfo'; | MODULE_NAME_KEY | "ohos.extra.param.key.module_name" | 卡片所属模块名称。 | | WIDTH_KEY | "ohos.extra.param.key.form_width" | 卡片宽度。 | | HEIGHT_KEY | "ohos.extra.param.key.form_height" | 卡片高度。 | -| TEMPORARY_KEY | "ohos.extra.param.key.form_temporary" | 临时卡片。 | \ No newline at end of file +| TEMPORARY_KEY | "ohos.extra.param.key.form_temporary" | 临时卡片。 | +| ABILITY_NAME_KEY | "ohos.extra.param.key.ability_name" | ability名称 | +| DEVICE_ID_KEY | "ohos.extra.param.key.device_id" | 设备标识 | \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-formerror.md b/zh-cn/application-dev/reference/apis/js-apis-formerror.md index cc9e3ac84012182c628fa36a2f78358a883caf95..f9233e3c77463f74be085fc8a932c2a58cee27aa 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-formerror.md +++ b/zh-cn/application-dev/reference/apis/js-apis-formerror.md @@ -48,4 +48,5 @@ SystemCapability.Ability.Form | ERR_SYSTEM_RESPONSES_FAILED | 30 | 系统服务响应失败 | | ERR_FORM_DUPLICATE_ADDED | 31 | 重复添加卡片 | | ERR_IN_RECOVERY | 36 | 卡片数据覆盖失败 | +| ERR_DISTRIBUTED_SCHEDULE_FAILED | 37 | 分布式调度失败 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-formextension.md b/zh-cn/application-dev/reference/apis/js-apis-formextension.md index 4c0c8a855454c9861d1d2ec95fc639445870bcb0..adb849a672682f1a89137380406173655a0ffbda 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-formextension.md +++ b/zh-cn/application-dev/reference/apis/js-apis-formextension.md @@ -249,4 +249,39 @@ onAcquireFormState?(want: Want): formInfo.FormState; return formInfo.FormState.UNKNOWN; } } + ``` + +## FormExtension.onShare + +onShare?(formId: string): {[key: string]: any}; + +卡片提供方接收卡片分享的通知接口。 + +**系统能力**:SystemCapability.Ability.Form + +**参数:** + + | 参数名 | 类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | formId | string | 是 | 卡片标识 | + +**返回值:** + + | 类型 | 说明 | + | ------------------------------------------------------------ | ----------------------------------------------------------- | + | {[key: string]: any} | 一个WantParams对象,卡片要分享的数据,由开发者自行决定传入的键值对。 | + +**示例:** + + ```js + class MyFormExtension extends FormExtension { + onShare(formId) { + console.log('FormExtension onShare, formId:' + formId); + let wantParams = { + "temperature":"20", + "time":"2022-8-8 09:59", + }; + return wantParams; + } + } ``` \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-formhost.md b/zh-cn/application-dev/reference/apis/js-apis-formhost.md index 485fbd39b9db947588dd0d43bd2a8e35330af552..7cc3f8e28c391086d1dac6e896d67c4be9f339aa 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-formhost.md +++ b/zh-cn/application-dev/reference/apis/js-apis-formhost.md @@ -1120,4 +1120,72 @@ notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean): }).catch((error) => { console.log('formHost notifyFormsEnableUpdate, error:' + JSON.stringify(error)); }); + ``` +## shareForm + +shareForm(formId: string, deviceId: string, callback: AsyncCallback<void>): void; + +指定formId和远程设备Id进行卡片分享。 + +**需要权限**:ohos.permission.REQUIRE_FORM + +**系统能力**:SystemCapability.Ability.Form + +**系统API**: 此接口为系统接口,三方应用不支持调用。 + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ------- | +| formId | string | 是 | 卡片标识 | +| deviceId | string | 是 | 远程设备标识 | +| callback | AsyncCallback<void> | 是 | callback形式返回结果 | + +**示例:** + + ```js + var formId = "12400633174999288"; + var deviceId = "EFC11C0C53628D8CC2F8CB5052477E130D075917034613B9884C55CD22B3DEF2"; + formHost.shareForm(formId, deviceId, (error, data) => { + if (error.code) { + console.log('formHost shareForm, error:' + JSON.stringify(error)); + } + }); + ``` + +## shareForm + +shareForm(formId: string, deviceId: string): Promise<void>; + +指定formId和远程设备Id进行卡片分享。 + +**需要权限**:ohos.permission.REQUIRE_FORM + +**系统能力**:SystemCapability.Ability.Form + +**系统API**: 此接口为系统接口,三方应用不支持调用。 + +**参数:** + + | 参数名 | 类型 | 必填 | 说明 | + | ------ | ------ | ---- | ------- | + | formId | string | 是 | 卡片标识 | + | deviceId | string | 是 | 远程设备标识 | + +**返回值:** + + | 类型 | 说明 | + | -------- | -------- | + | Promise<void> | 返回一个Promise,包含接口的结果 | + +**参数:** + + ```js + var formId = "12400633174999288"; + var deviceId = "EFC11C0C53628D8CC2F8CB5052477E130D075917034613B9884C55CD22B3DEF2"; + formHost.shareForm(formId, deviceId).then(() => { + console.log('formHost shareForm success'); + }).catch((error) => { + console.log('formHost shareForm, error:' + JSON.stringify(error)); + }); ``` \ No newline at end of file