Nhảy tới nội dung

Events

Bắt đầu hỗ trợ ở phiên bản:

  • API: 2.13.0

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 sdk, { Events } from 'zmp-sdk';

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

sdk.events.on(Events.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 sdk, { Events } from 'zmp-sdk';

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

sdk.events.once(Events.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 sdk, { Events } from 'zmp-sdk';

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

sdk.events.on(Events.NetworkChanged, callback);

// ...

sdk.off(Events.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 sdk, { Events } from 'zmp-sdk';

sdk.removeAllListeners(Events.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 sdk, { Events } from 'zmp-sdk';

sdk.events.on(Events.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 sdk, { Events } from 'zmp-sdk';

sdk.events.on(Events.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 sdk, { Events } from 'zmp-sdk';

sdk.events.on(Events.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 sdk, { Events } from 'zmp-sdk';

sdk.events.on(Events.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.01.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 sdk, { Events } from 'zmp-sdk';

sdk.events.on(Events.OpenApp, (data) => {
  console.log('Callback data:', data.path);
});

Events

zi-chevron-up