HarmonyOS实战开发：@ohos.app.form.formHost (formHost)

最新推荐文章于 2024-08-15 11:57:09 发布
最新推荐文章于 2024-08-15 11:57:09 发布
阅读量633 收藏 11
点赞数 11
分类专栏： 鸿蒙 文章标签： harmonyos 华为 鸿蒙 鸿蒙系统 android
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2401_84194030/article/details/138976835
版权

formHost模块提供了卡片使用方相关接口的能力，包括对使用方同一用户下安装的卡片进行删除、释放、请求更新、获取卡片信息、状态等操作。

说明：

本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 本模块接口均为系统接口。

导入模块

import formHost from '@ohos.app.form.formHost';

deleteForm

deleteForm(formId: string, callback: AsyncCallback<void>): void

删除指定的卡片。调用此方法后，应用程序将无法使用该卡片，卡片管理器服务不再保留有关该卡片的信息。使用callback异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdstring是卡片标识。
callbackAsyncCallback<void>是回调函数。当删除指定的卡片成功，error为undefined，否则为错误对象

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.
16501001The ID of the form to be operated does not exist.
16501003The form can not be operated by the current application.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  let formId: string = '12400633174999288';
  formHost.deleteForm(formId, (error: Base.BusinessError) => {
  if (error) {
    console.error(`error, code: ${error.code}, message: ${error.message}`);
  } else {
    console.log('formHost deleteForm success');
  }
  });
} catch (error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

deleteForm

deleteForm(formId: string): Promise<void>

删除指定的卡片。调用此方法后，应用程序将无法使用该卡片，卡片管理器服务不再保留有关该卡片的信息。使用Promise异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdstring是卡片标识。

返回值：

类型说明
Promise<void>无返回结果的Promise对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.
16501001The ID of the form to be operated does not exist.
16501003The form can not be operated by the current application.

以上错误码的详细介绍请参见卡片错误码。

参数：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  let formId: string = '12400633174999288';
  formHost.deleteForm(formId).then(() => {
    console.log('formHost deleteForm success');
  }).catch((error: Base.BusinessError) => {
    console.error(`formHost deleteForm, error: ${JSON.stringify(error)}`);
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

releaseForm

releaseForm(formId: string, callback: AsyncCallback<void>): void

释放指定的卡片。调用此方法后，应用程序将无法使用该卡片，但卡片管理器服务仍然保留有关该卡片的缓存信息和存储信息。使用callback异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdstring是卡片标识。
callbackAsyncCallback<void>是回调函数。当释放指定的卡片成功，error为undefined；否则为错误对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.
16501001The ID of the form to be operated does not exist.
16501003The form can not be operated by the current application.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  let formId: string = '12400633174999288';
  formHost.releaseForm(formId, (error: Base.BusinessError) => {
    if (error) {
      console.error(`error, code: ${error.code}, message: ${error.message}`);
    }
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

releaseForm

releaseForm(formId: string, isReleaseCache: boolean, callback: AsyncCallback<void>): void

释放指定的卡片。调用此方法后，应用程序将无法使用该卡片，卡片管理器服务保留有关该卡片的存储信息，可以选择是否保留缓存信息。使用callback异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdstring是卡片标识。
isReleaseCacheboolean是是否释放缓存。
callbackAsyncCallback<void>是回调函数。当释放指定的卡片成功，error为undefined；否则为错误对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.
16501001The ID of the form to be operated does not exist.
16501003The form can not be operated by the current application.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  let formId: string = '12400633174999288';
  formHost.releaseForm(formId, true, (error: Base.BusinessError) => {
    if (error) {
      console.error(`error, code: ${error.code}, message: ${error.message}`);
    }
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

releaseForm

releaseForm(formId: string, isReleaseCache?: boolean): Promise<void>

释放指定的卡片。调用此方法后，应用程序将无法使用该卡片，卡片管理器服务保留有关该卡片的存储信息，可以选择是否保留缓存信息。使用Promise异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdstring是卡片标识。
isReleaseCacheboolean否是否释放缓存，默认为false。

返回值：

类型说明
Promise<void>无返回结果的Promise对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.
16501001The ID of the form to be operated does not exist.
16501003The form can not be operated by the current application.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  let formId: string = '12400633174999288';
  formHost.releaseForm(formId, true).then(() => {
    console.log('formHost releaseForm success');
  }).catch((error: Base.BusinessError) => {
    console.error(`error, code: ${error.code}, message: ${error.message}`);
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

requestForm

requestForm(formId: string, callback: AsyncCallback<void>): void

请求卡片更新。使用callback异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdstring是卡片标识。
callbackAsyncCallback<void>是回调函数。当请求卡片更新成功，error为undefined；否则为错误对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.
16501001The ID of the form to be operated does not exist.
16501003The form can not be operated by the current application.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  let formId: string = '12400633174999288';
  formHost.requestForm(formId, (error: Base.BusinessError) => {
    if (error) {
      console.error(`error, code: ${error.code}, message: ${error.message}`);
    }
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

requestForm

requestForm(formId: string): Promise<void>

请求卡片更新。使用Promise异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdstring是卡片标识。

返回值：

类型说明
Promise<void>无返回结果的Promise对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.
16501001The ID of the form to be operated does not exist.
16501003The form can not be operated by the current application.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  let formId: string = '12400633174999288';
  formHost.requestForm(formId).then(() => {
    console.log('formHost requestForm success');
  }).catch((error: Base.BusinessError) => {
    console.error(`error, code: ${error.code}, message: ${error.message}`);
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

castToNormalForm

castToNormalForm(formId: string, callback: AsyncCallback<void>): void

将指定的临时卡片转换为普通卡片。使用callback异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdstring是卡片标识。
callbackAsyncCallback<void>是回调函数。当将指定的临时卡片转换为普通卡片成功，error为undefined，否则为错误对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16501000An internal functional error occurred.
16501001The ID of the form to be operated does not exist.
16501002The number of forms exceeds upper bound.
16501003The form can not be operated by the current application.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  let formId: string = '12400633174999288';
  formHost.castToNormalForm(formId, (error: Base.BusinessError) => {
    if (error) {
      console.error(`error, code: ${error.code}, message: ${error.message}`);
    }
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

castToNormalForm

castToNormalForm(formId: string): Promise<void>

将指定的临时卡片转换为普通卡片。使用Promise异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdstring是卡片标识。

返回值：

类型说明
Promise<void>无返回结果的Promise对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16501000An internal functional error occurred.
16501001The ID of the form to be operated does not exist.
16501002The number of forms exceeds upper bound.
16501003The form can not be operated by the current application.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  let formId: string = '12400633174999288';
  formHost.castToNormalForm(formId).then(() => {
    console.log('formHost castTempForm success');
  }).catch((error: Base.BusinessError) => {
    console.error(`error, code: ${error.code}, message: ${error.message}`);
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

notifyVisibleForms

notifyVisibleForms(formIds: Array<string>, callback: AsyncCallback<void>): void

向卡片框架发送通知以使指定的卡片可见。该方法调用成功后，会调用onVisibilityChange通知卡片提供方。使用callback异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdsArray<string>是卡片标识列表。
callbackAsyncCallback<void>是回调函数。当向卡片框架发送通知以使指定的卡片可见成功，error为undefined，否则为错误对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  let formId: string[] = ['12400633174999288'];
  formHost.notifyVisibleForms(formId, (error: Base.BusinessError) => {
    if (error) {
      console.error(`error, code: ${error.code}, message: ${error.message}`);
    }
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

notifyVisibleForms

notifyVisibleForms(formIds: Array<string>): Promise<void>

向卡片框架发送通知以使指定的卡片可见。该方法调用成功后，会调用onVisibilityChange通知卡片提供方。使用Promise异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdsArray<string>是卡片标识列表。

返回值：

类型说明
Promise<void>无返回结果的Promise对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  let formId: string[] = ['12400633174999288'];
  formHost.notifyVisibleForms(formId).then(() => {
    console.log('formHost notifyVisibleForms success');
  }).catch((error: Base.BusinessError) => {
    console.error(`error, code: ${error.code}, message: ${error.message}`);
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

notifyInvisibleForms

notifyInvisibleForms(formIds: Array<string>, callback: AsyncCallback<void>): void

向卡片框架发送通知以使指定的卡片不可见。该方法调用成功后，会调用onVisibilityChange通知卡片提供方。使用callback异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdsArray<string>是卡片标识列表。
callbackAsyncCallback<void>是回调函数。当向卡片框架发送通知以使指定的卡片不可见成功，error为undefined，否则为错误对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  let formId: string[] = ['12400633174999288'];
  formHost.notifyInvisibleForms(formId, (error: Base.BusinessError) => {
    if (error) {
      console.error(`error, code: ${error.code}, message: ${error.message}`);
    }
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

notifyInvisibleForms

notifyInvisibleForms(formIds: Array<string>): Promise<void>

向卡片框架发送通知以使指定的卡片不可见。该方法调用成功后，会调用onVisibilityChange通知卡片提供方。使用Promise异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdsArray<string>是卡片标识列表。

返回值：

类型说明
Promise<void>无返回结果的Promise对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  let formId: string[] = ['12400633174999288'];
  formHost.notifyInvisibleForms(formId).then(() => {
    console.log('formHost notifyInvisibleForms success');
  }).catch((error: Base.BusinessError) => {
    console.error(`error, code: ${error.code}, message: ${error.message}`);
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

enableFormsUpdate

enableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void>): void

向卡片框架发送通知以使指定的卡片可以更新。该方法调用成功后，卡片刷新状态设置为使能，卡片可以接收来自卡片提供方的更新。使用callback异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdsArray<string>是卡片标识列表。
callbackAsyncCallback<void>是回调函数。当向卡片框架发送通知以使指定的卡片可以更新成功，error为undefined，否则为错误对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.
16501003The form can not be operated by the current application.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  let formId: string[] = ['12400633174999288'];
  formHost.enableFormsUpdate(formId, (error: Base.BusinessError) => {
    if (error) {
      console.error(`error, code: ${error.code}, message: ${error.message}`);
    }
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

enableFormsUpdate

enableFormsUpdate(formIds: Array<string>): Promise<void>

向卡片框架发送通知以使指定的卡片可以更新。该方法调用成功后，卡片刷新状态设置为使能，卡片可以接收来自卡片提供方的更新。使用Promise异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdsArray<string>是卡片标识列表。

返回值：

类型说明
Promise<void>无返回结果的Promise对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.
16501003The form can not be operated by the current application.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  let formId: string[] = ['12400633174999288'];
  formHost.enableFormsUpdate(formId).then(() => {
    console.log('formHost enableFormsUpdate success');
  }).catch((error: Base.BusinessError) => {
    console.error(`error, code: ${error.code}, message: ${error.message}`);
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

disableFormsUpdate

disableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void>): void

向卡片框架发送通知以使指定的卡片不可以更新。该方法调用成功后，卡片刷新状态设置为去使能，卡片不可以接收来自卡片提供方的更新。使用callback异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdsArray<string>是卡片标识列表。
callbackAsyncCallback<void>是回调函数。当向卡片框架发送通知以使指定的卡片不可以更新成功，error为undefined，否则为错误对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.
16501001The ID of the form to be operated does not exist.
16501003The form can not be operated by the current application.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  let formId: string[] = ['12400633174999288'];
  formHost.disableFormsUpdate(formId, (error: Base.BusinessError) => {
    if (error) {
      console.error(`error, code: ${error.code}, message: ${error.message}`);
    }
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

disableFormsUpdate

disableFormsUpdate(formIds: Array<string>): Promise<void>

向卡片框架发送通知以使指定的卡片不可以更新。该方法调用成功后，卡片刷新状态设置为去使能，卡片不可以接收来自卡片提供方的更新。使用Promise异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdsArray<string>是卡片标识列表。

返回值：

类型说明
Promise<void>无返回结果的Promise对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.
16501001The ID of the form to be operated does not exist.
16501003The form can not be operated by the current application.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  let formId: string[] = ['12400633174999288'];
  formHost.disableFormsUpdate(formId).then(() => {
    console.log('formHost disableFormsUpdate success');
  }).catch((error: Base.BusinessError) => {
    console.error(`error, code: ${error.code}, message: ${error.message}`);
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

isSystemReady

isSystemReady(callback: AsyncCallback<void>): void

检查系统是否准备好。使用callback异步回调。

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
callbackAsyncCallback<void>是回调函数。当检查系统是否准备好成功，error为undefined，否则为错误对象。

错误码：

错误码ID错误信息
202The application is not a system application.
401If the input parameter is not valid parameter.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  formHost.isSystemReady((error: Base.BusinessError) => {
    if (error) {
      console.error(`error, code: ${error.code}, message: ${error.message}`);
    }
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

isSystemReady

isSystemReady(): Promise<void>

检查系统是否准备好。使用Promise异步回调。

系统能力：SystemCapability.Ability.Form

返回值：

类型说明
Promise<void>无返回结果的Promise对象。

错误码：

错误码ID错误信息
202The application is not a system application.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  formHost.isSystemReady().then(() => {
    console.log('formHost isSystemReady success');
  }).catch((error: Base.BusinessError) => {
    console.error(`error, code: ${error.code}, message: ${error.message}`);
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

getAllFormsInfo

getAllFormsInfo(callback: AsyncCallback<Array<formInfo.FormInfo>>): void

获取设备上所有应用提供的卡片信息。使用callback异步回调。

需要权限：ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
callbackAsyncCallback<Array<formInfo.FormInfo>>是回调函数。当获取设备上所有应用提供的卡片信息成功，error为undefined，data为查询到的卡片信息；否则为错误对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import formInfo from '@ohos.app.form.formInfo';
import Base from '@ohos.base';

try {
  formHost.getAllFormsInfo((error: Base.BusinessError, data: formInfo.FormInfo[]) => {
    if (error) {
      console.error(`error, code: ${error.code}, message: ${error.message}`);
    } else {
      console.log(`formHost getAllFormsInfo, data: ${JSON.stringify(data)}`);
    }
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

getAllFormsInfo

getAllFormsInfo(): Promise<Array<formInfo.FormInfo>>

获取设备上所有应用提供的卡片信息。使用Promise异步回调。

需要权限：ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力：SystemCapability.Ability.Form

返回值：

类型说明
Promise<Array<formInfo.FormInfo>>Promise对象，返回查询到的卡片信息。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import formInfo from '@ohos.app.form.formInfo';
import Base from '@ohos.base';

try {
  formHost.getAllFormsInfo().then((data: formInfo.FormInfo[]) => {
    console.log(`formHost getAllFormsInfo data: ${JSON.stringify(data)}`);
  }).catch((error: Base.BusinessError) => {
    console.error(`error, code: ${error.code}, message: ${error.message}`);
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

getFormsInfo

getFormsInfo(bundleName: string, callback: AsyncCallback<Array<formInfo.FormInfo>>): void

获取设备上指定应用程序提供的卡片信息。使用callback异步回调。

需要权限：ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
bundleNamestring是要查询的应用Bundle名称。
callbackAsyncCallback<Array<formInfo.FormInfo>>是回调函数。当获取设备上指定应用程序提供的卡片信息成功，error为undefined，data为查询到的卡片信息；否则为错误对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16500100Failed to obtain the configuration information.
16501000An internal functional error occurred.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import formInfo from '@ohos.app.form.formInfo';
import Base from '@ohos.base';

try {
  formHost.getFormsInfo('com.example.ohos.formjsdemo', (error: Base.BusinessError, data: formInfo.FormInfo[]) => {
    if (error) {
      console.error(`error, code: ${error.code}, message: ${error.message}`);
    } else {
      console.log(`formHost getFormsInfo, data: ${JSON.stringify(data)}`);
    }
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

getFormsInfo

getFormsInfo(bundleName: string, moduleName: string, callback: AsyncCallback<Array<formInfo.FormInfo>>): void

获取设备上指定应用程序提供的卡片信息。使用callback异步回调。

需要权限：ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
bundleNamestring是要查询的应用Bundle名称。
moduleNamestring是要查询的模块名称。
callbackAsyncCallback<Array<formInfo.FormInfo>>是回调函数。当获取设备上指定应用程序提供的卡片信息成功，error为undefined，data为查询到的卡片信息；否则为错误对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16500100Failed to obtain the configuration information.
16501000An internal functional error occurred.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import formInfo from '@ohos.app.form.formInfo';
import Base from '@ohos.base';

try {
  formHost.getFormsInfo('com.example.ohos.formjsdemo', 'entry', (error: Base.BusinessError, data: formInfo.FormInfo[]) => {
    if (error) {
      console.error(`error, code: ${error.code}, message: ${error.message}`);
    } else {
      console.log('formHost getFormsInfo, data: ${JSON.stringify(data)}');
    }
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

getFormsInfo

getFormsInfo(bundleName: string, moduleName?: string): Promise<Array<formInfo.FormInfo>>

获取设备上指定应用程序提供的卡片信息。使用Promise异步回调。

需要权限：ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
bundleNamestring是要查询的应用Bundle名称。
moduleNamestring否要查询的模块名称，缺省默认为空。

返回值：

类型说明
Promise<Array<formInfo.FormInfo>>Promise对象，返回查询到的卡片信息。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16500100Failed to obtain the configuration information.
16501000An internal functional error occurred.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import formInfo from '@ohos.app.form.formInfo';
import Base from '@ohos.base';

try {
  formHost.getFormsInfo('com.example.ohos.formjsdemo', 'entry').then((data: formInfo.FormInfo[]) => {
    console.log(`formHost getFormsInfo, data: ${JSON.stringify(data)}`);
  }).catch((error: Base.BusinessError) => {
    console.error(`error, code: ${error.code}, message: ${error.message}`);
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

deleteInvalidForms

deleteInvalidForms(formIds: Array<string>, callback: AsyncCallback<number>): void

根据列表删除应用程序的无效卡片。使用callback异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdsArray<string>是有效卡片标识列表。
callbackAsyncCallback<number>是回调函数。当根据列表删除应用程序的无效卡片成功，error为undefined，data为删除的卡片个数；否则为错误对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  let formIds: string[] = new Array('12400633174999288', '12400633174999289');
  formHost.deleteInvalidForms(formIds, (error: Base.BusinessError, data: number) => {
    if (error) {
      console.error(`error, code: ${error.code}, message: ${error.message}`);
    } else {
      console.log(`formHost deleteInvalidForms, data: ${JSON.stringify(data)}`);
    }
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

deleteInvalidForms

deleteInvalidForms(formIds: Array<string>): Promise<number>

根据列表删除应用程序的无效卡片。使用Promise异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdsArray<string>是有效卡片标识列表。

返回值：

类型说明
Promise<number>Promise对象，返回删除的卡片个数。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

try {
  let formIds: string[] = new Array('12400633174999288', '12400633174999289');
  formHost.deleteInvalidForms(formIds).then((data: number) => {
    console.log(`formHost deleteInvalidForms, data: ${JSON.stringify(data)}`);
  }).catch((error: Base.BusinessError) => {
    console.error(`error, code: ${error.code}, message: ${error.message}`);
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

acquireFormState

acquireFormState(want: Want, callback: AsyncCallback<formInfo.FormStateInfo>): void

获取卡片状态。使用callback异步回调。

需要权限：ohos.permission.REQUIRE_FORM 和 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
wantWant是查询卡片状态时携带的want信息。需要包含bundle名、ability名、module名、卡片名、卡片规格等。
callbackAsyncCallback<formInfo.FormStateInfo>是回调函数。当获取卡片状态成功，error为undefined，data为获取到的卡片状态；否则为错误对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16500100Failed to obtain the configuration information.
16501000An internal functional error occurred.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Want from '@ohos.app.ability.Want';
import formInfo from '@ohos.app.form.formInfo';
import Base from '@ohos.base';

let want: Want = {
  'deviceId': '',
  'bundleName': 'ohos.samples.FormApplication',
  'abilityName': 'FormAbility',
  'parameters': {
    'ohos.extra.param.key.module_name': 'entry',
    'ohos.extra.param.key.form_name': 'widget',
    'ohos.extra.param.key.form_dimension': 2
  }
};
try {
  formHost.acquireFormState(want, (error:Base.BusinessError, data: formInfo.FormStateInfo) => {
    if (error) {
      console.error(`error, code: ${error.code}, message: ${error.message}`);
    } else {
      console.log(`formHost acquireFormState, data: ${JSON.stringify(data)}`);
    }
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

acquireFormState

acquireFormState(want: Want): Promise<formInfo.FormStateInfo>

获取卡片状态。使用Promise异步回调。

需要权限：ohos.permission.REQUIRE_FORM 和 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
wantWant是查询卡片状态时携带的want信息。需要包含bundle名、ability名、module名、卡片名、卡片规格等。

返回值：

类型说明
Promise<formInfo.FormStateInfo>Promise对象，返回卡片状态。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16500100Failed to obtain the configuration information.
16501000An internal functional error occurred.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Want from '@ohos.app.ability.Want';
import formInfo from '@ohos.app.form.formInfo';
import Base from '@ohos.base';

let want: Want = {
  'deviceId': '',
  'bundleName': 'ohos.samples.FormApplication',
  'abilityName': 'FormAbility',
  'parameters': {
    'ohos.extra.param.key.module_name': 'entry',
    'ohos.extra.param.key.form_name': 'widget',
    'ohos.extra.param.key.form_dimension': 2
  }
};
try {
  formHost.acquireFormState(want).then((data: formInfo.FormStateInfo) => {
    console.log(`formHost acquireFormState, data: ${JSON.stringify(data)}`);
  }).catch((error: Base.BusinessError) => {
    console.error(`error, code: ${error.code}, message: ${error.message}`);
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

on('formUninstall')

on(type: 'formUninstall', callback: Callback<string>): void

订阅卡片卸载事件。使用callback异步回调。

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
typestring是填写'formUninstall'，表示卡片卸载事件。
callbackCallback<string>是回调函数。返回卡片标识。

错误码：

错误码ID错误信息
202The application is not a system application.
401If the input parameter is not valid parameter.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';

formHost.on('formUninstall', (formId: string) => {
  console.log(`formHost on formUninstall, formId: ${formId}`);
});

off('formUninstall')

off(type: 'formUninstall', callback?: Callback<string>): void

取消订阅卡片卸载事件。使用callback异步回调。

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
typestring是填写'formUninstall'，表示卡片卸载事件。
callbackCallback<string>否回调函数。返回卡片标识。缺省时，表示注销所有已注册事件回调。
需与对应on('formUninstall')的callback一致。

错误码：

错误码ID错误信息
202The application is not a system application.
401If the input parameter is not valid parameter.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';

formHost.off('formUninstall', (formId: string) => {
  console.log(`formHost on formUninstall, formId: ${formId}`);
});

notifyFormsVisible

notifyFormsVisible(formIds: Array<string>, isVisible: boolean, callback: AsyncCallback<void>): void

通知卡片是否可见。使用callback异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdsArray<string>是卡片标识列表。
isVisibleboolean是是否可见。
callbackAsyncCallback<void>是回调函数。当通知卡片是否可见成功，error为undefined，否则为错误对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.
16501003The form can not be operated by the current application.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

let formIds: string[] = new Array('12400633174999288', '12400633174999289');
try {
  formHost.notifyFormsVisible(formIds, true, (error: Base.BusinessError) => {
    if (error) {
      console.error(`error, code: ${error.code}, message: ${error.message}`);
    }
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

notifyFormsVisible

notifyFormsVisible(formIds: Array<string>, isVisible: boolean): Promise<void>

通知卡片是否可见。使用Promise异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdsArray<string>是卡片标识列表。
isVisibleboolean是是否可见。

返回值：

类型说明
Promise<void>无返回结果的Promise对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.
16501003The form can not be operated by the current application.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

let formIds: string[] = new Array('12400633174999288', '12400633174999289');
try {
  formHost.notifyFormsVisible(formIds, true).then(() => {
    console.log('formHost notifyFormsVisible success');
  }).catch((error: Base.BusinessError) => {
    console.error(`error, code: ${error.code}, message: ${error.message}`);
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

notifyFormsEnableUpdate

notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean, callback: AsyncCallback<void>): void

通知卡片是否启用更新状态。使用callback异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdsArray<string>是卡片标识列表。
isEnableUpdateboolean是是否使能更新。
callbackAsyncCallback<void>是回调函数。当通知卡片是否启用更新状态成功，error为undefined，否则为错误对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.
16501003The form can not be operated by the current application.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

let formIds: string[] = new Array('12400633174999288', '12400633174999289');
try {
  formHost.notifyFormsEnableUpdate(formIds, true, (error: Base.BusinessError) => {
    if (error) {
      console.error(`error, code: ${error.code}, message: ${error.message}`);
    }
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

notifyFormsEnableUpdate

notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean): Promise<void>

通知卡片是否启用更新状态。使用Promise异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdsArray<string>是卡片标识列表。
isEnableUpdateboolean是是否使能更新。

返回值：

类型说明
Promise<void>无返回结果的Promise对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.
16501003The form can not be operated by the current application.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

let formIds: string[] = new Array('12400633174999288', '12400633174999289');
try {
  formHost.notifyFormsEnableUpdate(formIds, true).then(() => {
    console.log('formHost notifyFormsEnableUpdate success');
  }).catch((error: Base.BusinessError) => {
    console.error(`error, code: ${error.code}, message: ${error.message}`);
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

shareForm

shareForm(formId: string, deviceId: string, callback: AsyncCallback<void>): void

指定formId和远程设备Id进行卡片分享。使用callback异步回调。

需要权限：ohos.permission.REQUIRE_FORM 和 ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdstring是卡片标识。
deviceIdstring是远程设备标识。
callbackAsyncCallback<void>是回调函数。当指定formId和远程设备Id进行卡片分享成功，error为undefined，否则为错误对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16501000An internal functional error occurred.
16501001The ID of the form to be operated does not exist.
16501003The form can not be operated by the current application.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

let formId: string = '12400633174999288';
let deviceId: string = 'EFC11C0C53628D8CC2F8CB5052477E130D075917034613B9884C55CD22B3DEF2';
try {
  formHost.shareForm(formId, deviceId, (error: Base.BusinessError) => {
    if (error) {
      console.error(`error, code: ${error.code}, message: ${error.message}`);
    }
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

shareForm

shareForm(formId: string, deviceId: string): Promise<void>

指定formId和远程设备Id进行卡片分享。使用Promise异步回调。

需要权限：ohos.permission.REQUIRE_FORM 和 ohos.permission.DISTRIBUTED_DATASYNC

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdstring是卡片标识。
deviceIdstring是远程设备标识。

返回值：

类型说明
Promise<void>无返回结果的Promise对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16501000An internal functional error occurred.
16501001The ID of the form to be operated does not exist.
16501003The form can not be operated by the current application.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

let formId: string = '12400633174999288';
let deviceId: string = 'EFC11C0C53628D8CC2F8CB5052477E130D075917034613B9884C55CD22B3DEF2';
try {
  formHost.shareForm(formId, deviceId).then(() => {
    console.log('formHost shareForm success');
  }).catch((error: Base.BusinessError) => {
    console.error(`error, code: ${error.code}, message: ${error.message}`);
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

notifyFormsPrivacyProtected

notifyFormsPrivacyProtected(formIds: Array<string>, isProtected: boolean, callback: AsyncCallback<void>): void

通知指定卡片隐私保护状态改变。使用callback异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdsArray<string>是需要修改隐私保护的卡片标识列表。
isProtectedboolean是是否进行隐私保护。
callbackAsyncCallback<void>是回调函数。当指定卡片设置隐私保护属性成功，error为undefined，否则为错误对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

let formIds: string[] = new Array('12400633174999288', '12400633174999289');
try {
  formHost.notifyFormsPrivacyProtected(formIds, true, (error: Base.BusinessError) => {
    if (error) {
      console.error(`error, code: ${error.code}, message: ${error.message}`);
    }
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

notifyFormsPrivacyProtected

notifyFormsPrivacyProtected(formIds: Array<string>, isProtected: boolean): Promise<void>

通知指定卡片隐私保护状态改变。使用Promise异步回调。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdsArray<string>是需要修改隐私保护的卡片标识列表。
isProtectedboolean是是否进行隐私保护。

返回值：

类型说明
Promise<void>无返回结果的Promise对象。

错误码：

错误码ID错误信息
201Permissions denied.
202The application is not a system application.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16501000An internal functional error occurred.

以上错误码的详细介绍请参见卡片错误码。

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

let formIds: string[] = new Array('12400633174999288', '12400633174999289');
try {
  formHost.notifyFormsPrivacyProtected(formIds, true).then(() => {
    console.log('formHost notifyFormsPrivacyProtected success');
  }).catch((error: Base.BusinessError) => {
    console.error(`error, code: ${error.code}, message: ${error.message}`);
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

acquireFormData10+

acquireFormData(formId: string, callback: AsyncCallback<{[key: string]: Object}>): void

请求卡片提供方数据。使用callback异步回调。

模型约束： 此接口仅可在Stage模型下使用。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdstring是卡片标识。
callbackAsyncCallback<{[key: string]: Object}是以callback方式返回接口运行结果及分享数据。

错误码：

错误码ID错误信息
201Permissions denied.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16500100Failed to obtain the configuration information.
16501000An internal functional error occurred.

以上错误码的详细介绍请参见卡片错误码。

示例：

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

let formId: string = '12400633174999288';
try {
  formHost.acquireFormData(formId, (error, data) => {
    if (error) {
      console.error(`error, code: ${error.code}, message: ${error.message}`);
    } else {
      console.log(`formHost acquireFormData, data: ${JSON.stringify(data)}`);
    }
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

acquireFormData10+

acquireFormData(formId: string): Promise<{[key: string]: Object}>

请求卡片提供方数据。使用Promise异步回调。

模型约束： 此接口仅可在Stage模型下使用。

需要权限：ohos.permission.REQUIRE_FORM

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdstring是卡片标识。

返回值：

类型说明
Promise<{[key: string]: Object}>以Promise方式返回接口运行结果及分享数据。

错误码：

错误码ID错误信息
201Permissions denied.
401If the input parameter is not valid parameter.
16500050An IPC connection error happened.
16500060A service connection error happened, please try again later.
16500100Failed to obtain the configuration information.
16501000An internal functional error occurred.

以上错误码的详细介绍请参见卡片错误码。

import formHost from '@ohos.app.form.formHost';
import Base from '@ohos.base';

let formId: string = '12400633174999288';
try {
  formHost.acquireFormData(formId).then((data) => {
    console.log('formHost acquireFormData success' + data);
  }).catch((error: Base.BusinessError) => {
    console.error(`error, code: ${error.code}, message: ${error.message}`);
  });
} catch(error) {
  console.error(`catch error, code: ${(error as Base.BusinessError).code}, message: ${(error as Base.BusinessError).message}`);
}

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。 

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

  •  HarmonOS基础技能

  • HarmonOS就业必备技能 
  •  HarmonOS多媒体技术

  • 鸿蒙NaPi组件进阶

  • HarmonOS高级技能

  • 初识HarmonOS内核 
  • 实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

图片

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

图片

 《鸿蒙开发基础》

  • ArkTS语言
  • 安装DevEco Studio
  • 运用你的第一个ArkTS应用
  • ArkUI声明式UI开发
  • .……

图片

 《鸿蒙开发进阶》

  • Stage模型入门
  • 网络管理
  • 数据管理
  • 电话服务
  • 分布式应用开发
  • 通知与窗口管理
  • 多媒体技术
  • 安全技能
  • 任务管理
  • WebGL
  • 国际化开发
  • 应用测试
  • DFX面向未来设计
  • 鸿蒙系统移植和裁剪定制
  • ……

图片

《鸿蒙进阶实战》

  • ArkTS实践
  • UIAbility应用
  • 网络案例
  • ……

图片

 获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。

蜀道衫QAQ
关注
  • 11
    点赞
  • 踩
  • 11
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
HarmonyOS NEXT应用开发之异常处理案例_import { logger } from ‘@ohos base‘；
2301_79054873的博客
04-15 990
|—PreferencesManager.ets // 数据模型层-持久化存储。| |—PreferencesManager.ets // 视图层-应用异常页面。
HarmonyOS和android-HarmonyOS-WishDemo:Wish107.5鸿蒙操作系统演示应用
07-01
在控制设备上打开入口app，然后授予多设备协作权限 连接同一个wifi网络中的所有设备 在所有设备上使用相同的华为帐号登录 设置所有设备之间的蓝牙连接 打开入口应用程序并单击投射按钮，然后单击设备名称以在目标...
HarmonyOS实战开发：@ohos.file.fs (文件管理)
2401_84194030的博客
06-01 1196
该模块为基础文件操作API，提供基础文件操作能力，包括文件基本管理、文件目录管理、文件信息统计、文件流式读写等常用功能。
如何使用命令行对RK开发板进行OpenHarmony版本烧录？
m0_64420071的博客
03-29 1428
开发版烧录
HarmonyOS实战开发：@ohos.app.ability.Want (Want)
2401_84194030的博客
05-16 693
Want是对象间信息传递的载体.........
华为鸿蒙HarmonyOS开发整理资料汇总.zip
11-25
华为鸿蒙HarmonyOS开发整理资料汇总，共38份。 1学前必读：HarmonyOS学习资源主题分享 2学前必读：OpenHarmony-联盟生态资料合集 3-1.HarmonyOS概述：技术特性 3-2.HarmonyOS概述：开发工具与平台 3-3.HarmonyOS...
HarmonyOS应用开发-自定义卡片.docx
06-03
### HarmonyOS应用开发之自定义卡片详解 #### 一、创建自定义卡片工程 在HarmonyOS应用开发中，自定义卡片是一种非常重要的功能组件，它允许开发者为用户提供快速访问应用核心功能或信息的方式。创建自定义卡片的...
HarmonyOS应用开发-PageAbility启动.docx
06-05
### HarmonyOS应用开发-PageAbility启动 #### 一、概述 HarmonyOS是华为推出的面向全场景的分布式操作系统，旨在为用户提供跨设备、无缝的智能体验。在HarmonyOS的应用开发过程中，Page Ability 和 Service ...
harmonyOS-基于鸿蒙开发的收支记账app.zip
01-20
【标题】：“harmonyOS-基于鸿蒙开发的收支记账app.zip”指的是一个使用华为鸿蒙操作系统（HarmonyOS）开发的财务管理应用程序的压缩文件。这个应用的主要功能可能包括记录个人或家庭的收入和支出，帮助用户进行财务...
HarmonyOS实战开发：@ohos.bundle.installer (installer模块)
2401_84194030的博客
05-25 898
本模块首批接口从API version 9 开始支持......
HarmonyOS 应用开发之通过关系型数据库实现数据持久化(1)
2401_84182392的博客
04-17 939
/ 建表Sql语句。// version = 2：表结构：EMPLOYEE (NAME, AGE, SALARY, CODES, ADDRESS) => version = 3：表结构：EMPLOYEE (NAME, AGE, SALARY, CODES)// version = 2：表结构：EMPLOYEE (NAME, AGE, SALARY, CODES, ADDRESS) => version = 3：表结构：EMPLOYEE (NAME, AGE, SALARY, CODES)
HarmonyOS应用开发学习-ArkUI-容器组件
最新发布
08-15 817
设置导航点样式:-left: 设置导航点距离Swiper组件左边的距离。-size:设置导航点的直径。例如,"1fr 1fr 2fr'是将父组件分3列，将父组件允许的宽分为4等份，第一列占1份，第二列占1份，第三列占2份。例如,"1fr 1fr 2fr”是将父组件分三行，将父组件允许的高分为4等份，第一行占1份，第二行占一份，第三行占2份。网格容器，由“行”和“列”分割的单元格所组成，通过指定”项目”所在的单元格做出各种各样的布局。设置为false是为横向Tabs，设置为true时为纵向Tabs。
【鸿蒙学习】HarmonyOS应用开发者基础 - 构建更加丰富的页面（一）
一个不断前行的程序者
08-14 831
ArkWeb是用于应用程序中显示Web页面内容的Web组件，为开发者提供页面加载、页面交互、页面调试等能力。可以实现移动端的混合式开发（Hybrid App）。
鸿蒙（API 12 Beta3版）【扩展屏投播开发指导】使用投播组件
鸿蒙的技术博客
08-14 1119
通过本节开发指导，可在系统镜像投屏后，获取投屏设备信息，实现扩展屏模式的投播，实现双屏协作的能力。
【鸿蒙学习】Stage模型与FA模型的对比与应用选择
一个不断前行的程序者
08-12 379
Stage模型是一种基于应用生命周期和功能模块划分的架构设计理念。它将应用分为多个阶段（Stage），每个阶段对应一个特定的任务或界面，使得应用结构更加清晰、开发更加高效。FA模型（Feature Ability Model）是鸿蒙OS中另一种应用架构设计理念，它以功能为单元，将应用划分为多个功能模块（Feature Ability），每个模块具有独立的生命周期和功能。Stage模型和FA模型各有优势，适用于不同的开发场景。普通开发者应根据项目需求、团队协作、性能要求等因素，选择最合适的模型。
HarmonyOS Developer之生成二维码
weixin_47988426的博客
08-14 290
生成二维码
鸿蒙开发Location Kit（位置服务）如何设置
A1551143530的博客
08-13 503
鸿蒙Location Kit 是一个强大的位置服务工具包，允许开发者在应用程序中集成精确的定位功能。Location Kit 提供了多种定位模式，支持室内和室外定位，并结合了GPS、Wi-Fi、蓝牙和基站等多种定位技术。
vue.esm.js:5105 [Vue warn]: data functions should return an object: https://v2.vuejs.org/v2/guide/components.html#data-Must-Be-a-Function found in ---> <ShouYe> at src/components/ShouYe.vue <App> at src/App.vue <Root> warn$2 @ vue.esm.js:5105 initData @ vue.esm.js:4385 initState @ vue.esm.js:4322 Vue._init @ vue.esm.js:4711 VueComponent @ vue.esm.js:5836 createComponentInstanceForVnode @ vue.esm.js:5044 init @ vue.esm.js:4906 merged @ vue.esm.js:5061 createComponent @ vue.esm.js:6578 createElm @ vue.esm.js:6532 createChildren @ vue.esm.js:6651 createElm @ vue.esm.js:6555 patch @ vue.esm.js:7082 Vue._update @ vue.esm.js:2870 updateComponent @ vue.esm.js:2980 Watcher.get @ vue.esm.js:4164 Watcher @ vue.esm.js:4154 mountComponent @ vue.esm.js:2997 Vue.$mount @ vue.esm.js:9312 Vue.$mount @ vue.esm.js:11877 init @ vue.esm.js:4907 createComponent @ vue.esm.js:6578 createElm @ vue.esm.js:6532 patch @ vue.esm.js:7120 Vue._update @ vue.esm.js:2870 updateComponent @ vue.esm.js:2980 Watcher.get @ vue.esm.js:4164 Watcher @ vue.esm.js:4154 mountComponent @ vue.esm.js:2997 Vue.$mount @ vue.esm.js:9312 Vue.$mount @ vue.esm.js:11877 Vue._init @ vue.esm.js:4721 Vue @ vue.esm.js:5772 eval @ main.js:14 ./src/main.js @ app.js:2520 __webpack_require__ @ app.js:679 fn @ app.js:89 0 @ app.js:2537 __webpack_require__ @ app.js:679 (anonymous) @ app.js:725 (anonymous) @ app.js:728
06-07
这个警告表示，在定义 Vue 组件时，data 选项应该是一个函数而不是一个对象。Vue 的官方文档说明，每个组件的 data 必须是一个函数，返回一个对象，而不是一个对象本身。这是为了确保每个组件实例都有一个独立的数据对象，而不是共享同一个数据对象。 解决方法是将 data 选项改成一个函数，例如： ```javascript export default { name: 'ShouYe', data() { return { // your data properties } } } ``` 这样就能避免这个警告了。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值