Khái niệm

Trang của bạn chạy trong khung bị khóa bên trong ứng dụng Lia và chỉ tiếp cận Lia thông qua SDK. Ba giao diện, thanh tiêu đề và menu của Lia, và các quy tắc mà trang của bạn chạy dưới.

#Khung

Khi ai đó mở ứng dụng của bạn, Lia hỏi máy chủ của nó xem họ có thể (xem Kiểm tra và trực tiếp), đăng nhập người chơi vào ứng dụng của bạn, và tải trang của bạn trong một khung bên trong ứng dụng Lia. Trang web của bạn là một trang web bình thường: bất kỳ khung nào, bất kỳ máy chủ nào, được cung cấp qua https.

Khung được khóa để mọi người có thể tin tưởng vào mọi ứng dụng trong Lia:

• Chỉ các trang riêng của bạn được tải. Khung vẫn ở trên ứng dụng của bạn'nguồn gốc (cơ chế, máy chủ và cổng). Một liên kết hoặc chuyển hướng đến bất kỳ trang web nào khác sẽ bị chặn. Mở các trang web khác bằng Lia.openLink.
• Trang của bạn vẫn có thể tải. Kịch bản, hình ảnh, phông chữ và fetch() các cuộc gọi đến các địa chỉ khác hoạt động như trên web (với CORS, như thường lệ).
• Không có cửa sổ bật lên hoặc cửa sổ mới, không có camera, microphone hoặc vị trí, và không có thanh toán của riêng bạn. Tiền, quảng cáo và bất cứ thứ gì trên điện thoại xảy ra trong Lia'các màn hình riêng của bạn trên ứng dụng của bạn.
• Lia chỉ nghe trang của bạn ở khung trên cùng. Các cuộc gọi SDK từ iframe bên trong trang của bạn, hoặc từ một trang ở nguồn khác, sẽ bị bỏ qua.
• Thông điệp nhỏ và được phân bổ đều. Một cuộc gọi vượt quá 16,000 ký tự sẽ bị bỏ qua (và hết thời gian). Hơn 20 cuộc gọi trong một giây sẽ bị từ chối với slow_down.

Lia'khung báo cáo LiaApps/1 ở cuối chuỗi user agent của nó, nếu bạn muốn nhận diện nó trên máy chủ của mình.

#Cầu nối

Demo SDK giao tiếp với Lia thông qua khung'cầu nối. Mỗi lần trang của bạn gọi là một tin nhắn với id; Lia trả lời một lần, và SDK chuyển đổi điều đó thành một lời hứa. Lia cũng gửi các sự kiện (giao diện thay đổi, ứng dụng tạm dừng) mà bạn lắng nghe bằng Lia.on.

Các cuộc gọi chờ đợi người dùng (bảng thanh toán, quảng cáo, máy quét, Face ID, hộp thoại) không có giới hạn thời gian. Mọi cuộc gọi khác sẽ thất bại với timeout nếu Lia không't câu trả lời trong 20 giây. Ngoài ứng dụng Lia không có cầu nối nào, và mọi cuộc gọi đều thất bại với not_in_lia.

#Ba kiểu dáng

Mỗi ứng dụng mở trong một trong ba giao diện, được thiết lập bởi nhóm Lia cho ứng dụng của bạn. Trang của bạn có thể chuyển đổi giữa chúng bằng SDK.

Lia.display nói cách ứng dụng của bạn được mở, và Lia.isFullscreen liệu nó'cạnh sát cạnh ngay bây giờ. Lia.requestFullscreen() và Lia.exitFullscreen() chuyển đổi giữa chế độ toàn màn hình và không toàn màn hình.

#Lia'tiêu đề và menu

Trong sheet và full, Lia vẽ một tiêu đề trên trang của bạn: ứng dụng của bạn'biểu tượng và tên (và Kiểm tra với tên nhà phát triển của bạn trong khi kiểm tra), một menu và Đóng. Bạn có thể màu sắc nó và hiển thị một nút quay lại trong đó.

Menu ⋯ luôn có:

• Cài đặt, khi trang của bạn hiển thị Lia.settingsButton.
• Bật/tắt thông báo, khi ứng dụng của bạn có thể gửi chúng (xem Thông báo).
• Tắt hoặc bật âm thanh, mà trang của bạn nghe được là soundChanged.
• Tải lại và Đóng.

#Trong khi trang của bạn đang tải

Lia hiển thị bộ tải riêng của nó trên ứng dụng của bạn từ lúc mở cho đến khi trang của bạn gọi Lia.ready() (hoặc tải xong). Gọi nó ngay khi màn hình đầu tiên của bạn được vẽ. Nếu trang của bạn không thể tải, Lia hiển thị một thông báo với 'Thử lại'.

#Tạm dừng và tiếp tục

Trang của bạn nghe pause khi Lia chuyển sang chế độ nền hoặc che ứng dụng của bạn bằng màn hình riêng của nó (thanh thanh toán, quảng cáo, hộp thoại, máy quét), và resume khi nó'nút quay lại. Tạm dừng đồng hồ, âm nhạc và vòng lặp trò chơi trên pause. Xem Chu kỳ sống và sự kiện.

#Một bảng tính tại một thời điểm

Lia hiển thị một trong những màn hình riêng của nó trên ứng dụng của bạn tại một thời điểm. Trong khi bảng thanh toán, quảng cáo, hộp thoại, người chọn bạn bè, yêu cầu thông báo, máy quét hoặc Face ID được mở, một cuộc gọi khác sẽ thất bại với busy.

#Ai có thể mở ứng dụng của bạn

• Mọi người cần một Lia tên người dùng mở bất kỳ ứng dụng nào.
• Trong khi ứng dụng của bạn ở kiểm tra, chỉ bạn và các nhà kiểm thử của bạn mới có thể mở nó. Khi nó's trực tiếp, mọi người đều có thể. Khi nó's tạm dừng, không ai có thể. Xem Kiểm tra và trực tiếp.
• Nếu đội Lia đã thiết lập một chuỗi tối thiểu cho ứng dụng của bạn, mọi người cần một chuỗi check-in dài như vậy để mở nó. Lia cho họ thấy cách đạt được điều đó.

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