了解Metaframe方法和事件

window.metaframe对象

加载脚本后，metaframe对象在应用程序的全局window对象中可用。metaframe对象包含管理Web应用中Metaframe所需的方法列表。

window.metaframe.create方法

方法签名：

window.metaframe.create: (parameters: {
 loginProjectId: string,
 merchantId?: number,
 projectId?: number,
 orbsApiHostId?: string,
 isMobile?: boolean,
 isCollapsed?: boolean,
 layoutSettings?: {
     desktop: {
       widgetMarginTop?: number,
     },
     mobile: {
       widgetMarginTop?: number,
     },
   },
}) => void;

在您的Web应用中初始化元框架。

window.metaframe.setIsMobile方法

方法签名：

window.metaframe.setIsMobile(isMobile: boolean)

将Metaframe从桌面版切换到移动版或反向切换。

window.metaframe.partnerActions对象

该对象包含在Metaframe中触发操作的方法。

使用此对象的方法之前，必须确保Metaframe已完全加载。为此，请订阅Metaframe加载事件。如果该事件已处理，则此对象的方法可用。

设置Metaframe加载事件侦听器的示例：

window.addEventListener("@metaframe-partner-events:app-loaded", () => {

 //Here you can use partner actions

});

window.metaframe.partnerActions.openBackpackItemPage方法

方法签名：

openBackpackItemPage: (itemId: string) => void;

打开Backpack部分中指定商品的页面。

要使该方法正常工作，必须满足以下条件：

• 在发布商帐户中启用了背包功能。
• 用户已通过认证进入了Metaframe。

window.metaframe.partnerActions.openLogin方法

方法签名：

openLogin: () => void;

打开用户授权表单。如果用户已授权，浏览器控制台将显示错误信息。

window.metaframe.partnerActions.openProfile方法

方法签名：

openProfile: () => void;

为当前用户打开Profile区段。如果用户未授权，浏览器控制台将显示错误信息。

window.metaframe.partnerActions.openWallet方法

方法签名：

openWallet: () => void;

为当前用户打开Wallet区段。如果用户未授权，浏览器控制台将显示错误信息。

window.metaframe.partnerActions.openBackpack方法

方法签名：

openBackpack: () => void;

为当前用户打开Backpack区段。如果用户未授权，浏览器控制台将显示错误信息。

window.metaframe.partnerActions.openCustomMiniApp方法

方法签名：

openCustomMiniApp: (params: {miniAppName: string}) => void;

在满足以下条件之一时，打开指定的Iframe类型自定义区段：

• 如果指定自定义区段设置中的用户登录前显示此应用开关已启用，且当前用户未授权。
• 如果指定用户区段设置中的用户登录后显示此应用开关已启用，且当前用户已授权。

如果不满足条件，浏览器控制台将显示错误信息。

window.metaframe.partnerActions.pushNotification方法

方法签名：

pushNotification: (params: {
  type: string; // use “success”, “warning”, “error” or “info”
  text: string;
  button?: {
    text: string;
    onClick: () => void;
  };
  durationInMs?: number;
}) => void;

将新通知推送到通知栈。

window.metaframe.partnerActions.setIsCustomMiniAppVisible方法

方法签名：

setIsCustomMiniAppVisible: (params: {
  miniAppName: string;
  isVisible: boolean;
}) => void;

显示或隐藏指定的自定义区段。

小组件事件

您可以订阅以下Metaframe事件：

跟踪自定义区段的事件

您可以在元框架中添加“操作”类型的自定义区段。此区段将显示为一个按钮，单击后执行相应操作，如打开网站。

要跟踪单击自定义区段的事件，您需要订阅@metaframe:custom-action:<ACTION_ID>事件，其中<ACTION_ID>是在发布商帐户中设置自定义区段时生成的操作ID。

设置自定义区段点击事件侦听器的示例：

document.addEventListener("@metaframe:custom-action:00000000-0000-0000-0000-000000000000", () => {

 // Your code here...

})