Tham khảo SDK

Khởi động và vòng đời

Sao chép trang

Lia.init, Lia.ready, Lia.session và Lia.close, và mọi sự kiện Lia gửi đến trang của bạn.

#Lia.init()

Gọi nó trước tiên. Nó trả lời bằng việc xác định người chơi là ai và mọi thứ về cách ứng dụng của bạn được hiển thị, và điền vào SDK's tính chất và CSS biến số.

const me = await Lia.init();

Giải quyết với:

Trường	Loại	Cái gì nó là
`player`	đối tượng	`{ id, name }`: người chơi'id của nó trong ứng dụng của bạn, và tên người dùng Lia của họ. Xem Người chơi.
`session`	chuỗi	Một mã thông báo phiên cho máy chủ của bạn, `lias_…`.
`exp`	số	Khi phiên kết thúc, tính bằng mili giây kể từ 1970 (15 phút sau khi mở).
`mode`	chuỗi	`"test"` hoặc `"live"`.
`language`	chuỗi	Người'ngôn ngữ trong Lia, ví dụ như `"en"`.
`rtl`	boolean	Có phải nó được đọc từ trái sang phải.
`platform`	chuỗi	`"ios"` hoặc `"android"`.
`theme`	chuỗi	`"light"` hoặc `"dark"`.
`themeParams`	đối tượng	Lia'màu sắc (`bg_color`, `text_color`…).
`display`	chuỗi	`"sheet"`, `"full"` hoặc `"fullscreen"`.
`isFullscreen`	boolean	Từ cạnh này sang cạnh kia hoặc không.
`viewport`	đối tượng	`{ height, expanded }`
`safeArea`	đối tượng	`{ top, bottom, left, right }` trong px
`contentSafeArea`	đối tượng	`{ top, bottom, left, right }` trong px
`startParam`	chuỗi hoặc null	Điều mà ứng dụng của bạn đã mở.
`link`	chuỗi	Ứng dụng của bạn'link mời của nó, không có startParam.
`sound`	boolean	Liệu người đó có muốn ứng dụng của bạn'âm thanh.
`notifications`	đối tượng	`{ allowed, available }`: liệu họ có cho phép thông báo của bạn hay không, và liệu ứng dụng của bạn có thể yêu cầu hay không.

Lỗi: not_in_lia, not_ready (Lia vẫn đang mở ứng dụng; thử lại sau một chút), timeout.

#Lia.ready()

Thông báo cho Lia rằng trang của bạn đã được vẽ, vì vậy nó sẽ loại bỏ trình tải. Gọi nó khi màn hình đầu tiên của bạn đã trên trang. Trả về không gì.

Lia.init().then(function (me) {
  renderHome(me);
  Lia.ready();
});

#Lia.session()

Một mã phiên mới cho máy chủ của bạn. Phiên sẽ kéo dài 15 phút, vì vậy hãy lấy một mã mới trước khi các cuộc gọi mà máy chủ của bạn phải tin tưởng.

const { session, exp } = await Lia.session();

Giải quyết với { session, exp }. Lỗi: not_open (người dùng không'chưa mở ứng dụng của bạn trong Lia; gọi init() đầu tiên), timeout.

#Lia.close()

Đóng ứng dụng của bạn. Giải quyết với null. Nếu bạn đã bật xác nhận đóng, điều này đóng lại mà không hỏi.

#Lia.on(event, listener)

Lắng nghe một trong Lia'sự kiện. Trả về một hàm để dừng lắng nghe.

const stop = Lia.on("theme", function (data) { redraw(data.colorScheme); });
// later
stop();

Ném bad_listener nếu listener không't một hàm. Một trình lắng nghe mà ném ra'dừng những cái khác.

#Lia.off(event, listener)

Dừng một trình lắng nghe được thêm bằng Lia.on.

#Lia.onPause(listener)

Giống như Lia.on("pause", listener). Trả về một hàm dừng lắng nghe.

#Lia.onResume(listener)

Giống như Lia.on("resume", listener).

#Sự kiện

Sự kiện	Dữ liệu	Khi nào
`"pause"`	không có	Lia đã chuyển sang nền tảng, hoặc một trong Lia'các màn hình (phiếu thanh toán, quảng cáo, hộp thoại) che khuất ứng dụng của bạn. Tạm dừng đồng hồ và âm thanh.
`"resume"`	không có	Quay lại.
`"theme"`	`{ theme, colorScheme }`	Người đã chuyển đổi Lia giữa chế độ sáng và tối. `theme` là các màu mới. Các biến CSS đã được cập nhật.
`"viewport"`	`{ height, expanded, isStateStable }`	Trang của bạn'chiều cao của nó thay đổi (một tấm kéo lên, nút dưới được hiển thị).
`"fullscreenChanged"`	`{ isFullscreen, contentSafeArea }`	Ứng dụng của bạn chuyển đến hoặc khỏi chế độ toàn màn hình.
`"languageChanged"`	`{ language, rtl }`	Người đã thay đổi Lia'ngôn ngữ của nó.
`"startParam"`	`{ startParam }`	Một thông báo hoặc lời mời cho ứng dụng của bạn đã được mở khi nó đã mở.
`"notificationsChanged"`	`{ allowed }`	Người cho phép hoặc dừng ứng dụng của bạn'thông báo.
`"soundChanged"`	`{ on }`	Người đã tắt tiếng hoặc mở tiếng ứng dụng của bạn từ Lia'mà menu ⋯.
`"charge"`	`{ chargeId, productId }`	Một giao dịch được xác nhận trong khi không `Lia.pay()` đang chờ (sau khi tải lại). Cũng `Lia.onCharge`.
`"ad"`	`{ state, format }`	Một quảng cáo'giai đoạn: `"loading"`, `"showing"` hoặc `"closed"`. Cũng `Lia.onAd`.
`"banner"`	`{ state, position, height, reason? }`	Banner's `"loading"`, `"shown"`, `"failed"` hoặc `"hidden"`. Cũng `Lia.onBanner`.
`"nativeAd"`	`{ state, placement, height? }`	Một quảng cáo bản địa's `"loading"`, `"showing"` hoặc `"closed"`. Cũng `Lia.onNativeAd`.
`"safeAreaChanged"`	`{ safeArea, contentSafeArea }`	Một thanh thông báo được cố định hoặc thẻ bản địa đã lấy hoặc trả lại một cạnh: Lia có khoảng trống xung quanh nó, vì vậy khu vực an toàn của bạn ở đó là 0. CSS biến đã được cập nhật.
`"mainButtonClicked"`	không có	Nút chính đã được nhấn. Cũng `Lia.mainButton.onClick`.
`"secondaryButtonClicked"`	không có	Nút phụ đã được nhấn.
`"backButtonClicked"`	không có	Thanh tiêu đề'nút quay lại đã được nhấn.
`"settingsButtonClicked"`	không có	Cài đặt đã được chọn trong menu ⋯.
`"accelerometerChanged"`	`{ x, y, z }`	Một lần đo trong khi gia tốc kế đang chạy.
`"gyroscopeChanged"`	`{ x, y, z }`	Một lần đo trong khi la bàn kỹ thuật số đang chạy.
`"deviceOrientationChanged"`	`{ alpha, beta, gamma }`	Một lần đo trong khi định hướng đang chạy.
`"accelerometerStarted"`, `"accelerometerStopped"`	không có	Cảm biến đã bắt đầu hoặc dừng lại. Cũng dành cho `gyroscope` và `deviceOrientation`.

Demo SDK cập nhật các thuộc tính của chính nó (Lia.colorScheme, Lia.viewport, Lia.language, Lia.soundOn và phần còn lại) trước khi các trình nghe của bạn chạy.

Được dịch tự động. Tiếng Anh là nguồn tin cậy. Đọc bằng tiếng Anh