了解Metaframe方法和事件

window.metaframe对象

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

window.metaframe.create方法

方法签名：

 1window.metaframe.create: (parameters: {
 2 loginProjectId: string,
 3 merchantId?: number,
 4 projectId?: number,
 5 orbsApiHostId?: string,
 6 isMobile?: boolean,
 7 isCollapsed?: boolean,
 8 layoutSettings?: {
 9     desktop: {
10       widgetMarginTop?: number,
11     },
12     mobile: {
13       widgetMarginTop?: number,
14     },
15   },
16}) => void;

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

window.metaframe.setIsMobile方法

方法签名：

1window.metaframe.setIsMobile(isMobile: boolean)

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

window.metaframe.partnerActions对象

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

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

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

1window.addEventListener("@metaframe-partner-events:app-loaded", () => {
2
3 //Here you can use partner actions
4
5});

window.metaframe.partnerActions.openBackpackItemPage方法

方法签名：

1openBackpackItemPage: (itemId: string) => void;

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

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

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

window.metaframe.partnerActions.openLogin方法

方法签名：

1openLogin: () => void;

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

window.metaframe.partnerActions.openProfile方法

方法签名：

1openProfile: () => void;

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

window.metaframe.partnerActions.openWallet方法

方法签名：

1openWallet: () => void;

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

window.metaframe.partnerActions.openBackpack方法

方法签名：

1openBackpack: () => void;

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

window.metaframe.partnerActions.openCustomMiniApp方法

方法签名：

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

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

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

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

window.metaframe.partnerActions.pushNotification方法

方法签名：

1pushNotification: (params: {
2  type: string; // use “success”, “warning”, “error” or “info”
3  text: string;
4  button?: {
5    text: string;
6    onClick: () => void;
7  };
8  durationInMs?: number;
9}) => void;

将新通知推送到通知栈。

window.metaframe.partnerActions.setIsCustomMiniAppVisible方法

方法签名：

1setIsCustomMiniAppVisible: (params: {
2  miniAppName: string;
3  isVisible: boolean;
4}) => void;

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

小组件事件

您可以订阅以下Metaframe事件：

跟踪自定义区段的事件

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

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

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

1document.addEventListener("@metaframe:custom-action:00000000-0000-0000-0000-000000000000", () => {
2
3 // Your code here...
4
5})