Hệ thống Mini App Widget

Hệ thống Widget cho phép Mini App mở rộng khả năng hiển thị ra ngoài phạm vi, đưa nội dung thu gọn của ứng dụng đến nhiều vị trí khác nhau trên App Host.

Widget được khởi tạo theo bộ các template cung cấp sẵn. Tuỳ thuộc vào loại widget và thời điểm cập nhật, Mini App sẽ sử dụng JS API để điều khiển nội dung hiển thị.

ghi chú

Hệ thống Widget hiện đang trong giai đoạn hoàn thiện tính năng. Các API và hành vi có thể thay đổi trong các phiên bản tiếp theo.

Các loại Widget

Live Widget

Live Widget hiển thị đồng bộ trạng thái thời gian thực của Mini App với trạng thái của Widget trên App Host. Phù hợp cho các tình huống cần cập nhật liên tục như theo dõi đơn hàng, tiến trình giao dịch, hay điều hướng.

JS Apis

API	Mô tả
createWidget	Tạo một Live Widget
updateWidgetConfigs	Cập nhật cấu hình và nội dung widget
removeWidget	Xoá widget đang hoạt động

Events

Event	Mô tả
onWidgetUpdate	Nhận thông báo khi đến chu kỳ cập nhật widget
onWidgetRemove	Nhận thông báo khi widget bị xoá
onWidgetTap	Nhận thông báo khi người dùng nhấn vào widget

Widget Templates

Template	Mô tả
ride-hailing	Gọi xe, theo dõi tài xế

Giới hạn

Tham số	Giá trị	Mô tả
updateInterval	≥ 5 giây	Chu kỳ cập nhật tối thiểu
duration	≤ 1200 giây (20 phút)	Thời gian tồn tại tối đa