Chuyển tới nội dung chính
ZZalo Platforms

Events

Cập nhật lần cuối:
Lưu ý

Từ phiên bản API 2.25.3, 'Events' sẽ được đổi tên thành 'EventName' để rõ ràng hơn.

API​

on(eventName, listener)​

  • eventName <string>: Tên của sự kiện
  • listener <Function>: Hàm xử lý sự kiện

Thêm một hàm vào cuối mảng chứa hàm xử lý đã có của sự kiện theo tên biến eventName. Khi sự kiện xảy ra, tất cả các hàm xử lý của sự kiện đó sẽ được gọi.

import { events, EventName } from "zmp-sdk/apis";

const callback = (data) => {
  console.log(data);
};
events.on(EventName.NetworkChanged, callback);

once(eventName, listener)​

  • eventName <string>: Tên của sự kiện
  • listener <Function>: Callback function

Thêm hàm xử lý một lần cho sự kiện theo tên biến eventName. Khi sự kiện xảy ra, hàm xử lý này sẽ bị xoá và sau đó thực thi.

import { events, EventName } from "zmp-sdk/apis";

const callback = (data) => {
  console.log(data);
};
events.once(EventName.NetworkChanged, callback);

off(eventName, listener)​

  • eventName <string>: Tên của sự kiện
  • listener <Function>: Callback function

Xoá một hàm xử lý cụ thể trong mảng các hàm xử lý của sự kiện theo tên biến eventName

import { events, EventName } from "zmp-sdk/apis";

const callback = (data) => {
  console.log(data);
};

events.on(EventName.NetworkChanged, callback);

// ...

events.off(EventName.NetworkChanged, callback);

removeAllListeners(eventName)​

  • eventName <string>: Tên của sự kiện

Xoá tất cả hàm xử lý của sự kiện theo tên biến eventName

import { events, EventName } from "zmp-sdk/apis";

events.removeAllListeners(EventName.NetworkChanged);

Events​

Zalo Mini App hỗ trợ các event sau đây:

AppPaused​

Sự kiện này xảy ra khi Zalo Mini App chuyển từ foreground sang background

import { events, EventName } from "zmp-sdk/apis";

events.on(EventName.AppPaused, () => {
  console.log("App paused");
});

AppResumed​

Sự kiện này xảy ra khi Zalo Mini App chuyển từ background sang foreground

import { events, EventName } from "zmp-sdk/apis";

events.on(EventName.AppResumed, () => {
  console.log("App resumed");
});

NetworkChanged​

Sự kiện này xảy ra khi phát hiện thay đổi mạng của thiết bị

import { events, EventName } from "zmp-sdk/apis";

events.on(EventName.NetworkChanged, (data) => {
  const { state } = data;
  console.log("Network State:", state);
});

OnDataCallback​

Sự kiện này xảy ra khi nhận được data từ api sendDataToPreviousMiniApp

import { events, EventName } from "zmp-sdk/apis";

events.on(EventName.OnDataCallback, (data) => {
  console.log("Callback data:", data);
});

OpenApp​

Bắt đầu hỗ trợ:

  • API phiên bản: 2.16.0
  • IOS: 22.02.01
  • Android: 22.03.02

Khi Mini App đang chạy ở chế độ nền (chưa tắt hẳn) mà được mở lại bằng các entrypoint như link, QR code,... thì sự kiện OpenApp sẽ xảy ra, giá trị nhận được là path của entrypoint đó.

import { events, EventName } from "zmp-sdk/apis";

events.on(EventName.OpenApp, (data) => {
  console.log("Callback data:", data.path);
});

WebviewClosed​

Bắt đầu hỗ trợ:

  • API phiên bản: 2.30.0

Sự kiện xảy ra khi webview mở từ miniapp được đóng lại.

import { events, EventName } from "zmp-sdk/apis";

events.on(EventName.WebviewClosed, () => {
  console.log("WebviewClosed");
});