LiaNhà phát triển

Tham khảo SDK

Lia.pay, Lia.charges và Lia.onCharge cho bảng thanh toán Lia's, Lia.showAd và các phím tắt cho quảng cáo toàn màn hình, và Lia.showBanner và Lia.showNativeAd cho quảng cáo banner và quảng cáo tự nhiên.

#Thanh toán

Xem Thanh toán và bảng thanh toán vì cách chúng hoạt động, và Bán một vật phẩm cho toàn bộ quy trình.

#Lia.pay(productId, options)

Mở Lia'bảng thanh toán của bạn cho một trong các sản phẩm của bạn. Giải quyết một khi nó'đã thanh toán; từ chối nếu nó không't.

const { chargeId, productId } = await Lia.pay("extra-lives");

// With your own key (SDK 1.5): asking again with the same key charges once and answers with the same chargeId.
const order = "order-" + crypto.randomUUID();
const paid = await Lia.pay("extra-lives", { idempotencyKey: order });
Tham sốLoại
productIdchuỗiMột trong các sản phẩm của bạn' ids, lên đến 64 ký tự.
options.idempotencyKeychuỗiTùy chọn, 1 đến 64 chữ cái, số, _, -, . và :. Xem Khóa không đổi.

Giải quyết với { chargeId, productId }. Sau đó gửi chargeId đến máy chủ của bạn để giao nó.

LỗiKhi nào
cancelledNgười đã đóng bảng mà không thanh toán.
no_productKhông có sản phẩm nào với id đó.
busyMột trong những Lia'các màn hình đang mở trên ứng dụng của bạn.
bad_productIdId không phải'ký tự tối đa 64.
bad_idempotency_keyKhóa không phải'ở đúng hình dạng.
not_ready, not_in_liaLia không thể'sẵn sàng, hoặc đây không phải là't Lia.

Nếu trang được tải lại khi bảng đang mở, khoản phí sẽ đến dưới dạng "charge" sự kiện thay vào đó (xem Lia.onCharge).

#Khóa không đổi

Từ SDK 1.5, các cuộc gọi thay đổi điều gì đó (Lia.pay, Lia.inviteFriend, Lia.submitScore và lưu trữ đám mây'mà ghi chú) có một tùy chọn idempotencyKey. Cùng khóa đó, trong vòng 24 giờ, không'làm nó hai lần: nó trả lời như lần gọi đầu tiên.

  • Lia đã lưu lại mỗi cuộc gọi một lần khi nó tự thử lại (kết nối bị mất). Khóa của bạn tự thêm tính an toàn tương tự trên trang của bạn'các lần thử lại và tải lại: giữ nó (trong Lia.deviceStorage, nói) cho đến khi cuộc gọi được trả lời.
  • Tạo một khóa cho mỗi hành động (crypto.randomUUID() là được phép (và có thể tái sử dụng chỉ để thử lại hành động đó.
  • Cùng một khóa với các tham số khác bị từ chối. Sử dụng một khóa mới cho hành động mới.
  • Đối với một giao dịch, bảng thanh toán vẫn mở để người đó xác nhận; xác nhận bằng khóa đã thanh toán sẽ trả lời bằng khoản phí đầu tiên và không tính thêm phí nào.
  • Một ứng dụng Lia cũ hơn SDK 1.5'phiên bản phát hành bỏ qua khóa, vì vậy cuộc gọi vẫn hoạt động, chỉ không có khóa của bạn.

#Lia.charges()

Người chơi này'các khoản phí đã thanh toán của bạn mà máy chủ của bạn không'chưa giao yet, theo thứ tự cũ nhất, lên đến 50. Gọi nó khi ứng dụng của bạn mở, và giao bất kỳ cái nào bạn tìm thấy.

const pending = await Lia.charges(); // [{ chargeId, productId }]
for (const charge of pending) await deliverOnServer(charge.chargeId);

Giải quyết với một mảng của { chargeId, productId }.

#Lia.onCharge(listener)

Nghe một khoản phí đã được xác nhận trong khi không Lia.pay() đang chờ, ví dụ sau khi tải lại. Người lắng nghe nhận được { chargeId, productId }. Trả về một hàm dừng lắng nghe. Cũng giống như Lia.on("charge", listener).

#Quảng cáo

Xem Quảng cáo cho các định dạng, nhịp điệu và kiểm tra máy chủ của bạn.

#Lia.showAd(options)

Chạy quảng cáo toàn màn hình trên ứng dụng của bạn. Kết thúc khi nó'được đóng.

const result = await Lia.showAd({ format: "rewarded" });
if (result.watched) giveReward(result.adId);
Tùy chọnLoại
formatchuỗi"rewarded" (mặc định), "rewardedInterstitial" hoặc "interstitial".
onStatehàmTùy chọn. Nghe mỗi giai đoạn: "loading", "showing", "closed".

Giải quyết với:

TrườngLoại
watchedbooleanMột quảng cáo được thưởng đã được xem đến hết.
shownbooleanMột quảng cáo xuất hiện trên màn hình.
adIdchuỗiHiện ra khi watched là đúng, và khi một quảng cáo trung gian được hiển thị. Kiểm tra nó trên máy chủ của bạn với POST /ads/verify.
reasonchuỗiKhi nào watched là sai: cancelled, skipped, no_ad, too_soon, failed hoặc một vấn đề kết nối.

Lỗi: bad_format, busy. Không có quảng cáo để hiển thị't một lỗi: nó giải quyết với reason: "no_ad".

#Lia.showRewardedAd(options)

Giống như Lia.showAd({ format: "rewarded", onState }). Một video mà người đó đã chọn xem.

#Lia.showRewardedInterstitialAd(options)

Giống như Lia.showAd({ format: "rewardedInterstitial", onState }). Lia trước tiên hỏi người, với Xem và Bỏ qua; Bỏ qua sẽ được giải quyết bằng reason: "skipped".

#Lia.showInterstitialAd(options)

Giống như Lia.showAd({ format: "interstitial", onState }). Cầu nối để sử dụng giữa các vòng. Được điều chỉnh bởi Lia (mặc định là tối đa một lần mỗi 90 giây và mỗi 2nd lần hỏi): khi nó không'đến lượt nó, nó sẽ được giải quyết ngay lập tức với shown: false, reason: "too_soon".

// Between rounds: ask every time, and let Lia decide.
await Lia.showInterstitialAd();
startNextRound();

#Lia.onAd(listener)

Nghe mọi quảng cáo'giai đoạn, { state, format }, với state một trong số "loading", "showing" và "closed". Trả về một hàm dừng lắng nghe. Cũng giống như Lia.on("ad", listener).

#Lia.showBanner(options)

Gắn một thanh thông báo thích ứng ở cạnh trên hoặc dưới, được vẽ bởi Lia bên ngoài trang của bạn. Trang của bạn sẽ ngắn lại để vừa với nó, do đó nó sẽ không bao giờ che bất kỳ thứ gì (SDK 1.7). Được giải quyết khi nó'được hiển thị, hoặc một khi Lia từ bỏ (khoảng 10 giây).

const banner = await Lia.showBanner({ position: "bottom" });
if (banner.shown) console.log("Banner is", banner.height, "px");
Tùy chọnLoại
positionchuỗi"bottom" (mặc định) hoặc "top". Trong chế độ toàn màn hình, một thanh trên nằm dưới Lia'các nút Close và ⋯ trôi nổi.

Giải quyết với { shown: true, position, height }, hoặc { shown: false, reason } với reason một trong số no_ad (không có gì được tải) và off (đội ngũ Lia đã tắt banner). Hỏi lại vị trí giống nhau sẽ trả lời bằng banner đã bật; hỏi vị trí khác sẽ di chuyển nó. AdMob làm mới nó trong khi nó'mà bật lên.

Lỗi: bad_position.

#Lia.hideBanner()

Loại bỏ banner; trang của bạn lấy lại không gian của nó. Giải quyết với { hidden: true }.

#Lia.banner

Banner hiện tại: { visible, position, height } (position là null và height 0 khi có'không có). --lia-banner-height giữ cùng chiều cao như một biến CSS.

#Lia.onBanner(listener)

Nghe sự thay đổi của thanh quảng cáo: { state, position, height, reason? }, với state một trong số "loading", "shown" (lại sau khi làm mới đã thay đổi chiều cao), "failed" và "hidden". Một thanh dưới cùng là "hidden" trong khi một thẻ gốc thay thế cho nó, sau đó "loading" và "shown" lại. Trả về một hàm dừng lắng nghe. Giống như Lia.on("banner", listener).

#Lia.showNativeAd(options)

Một quảng cáo bản địa trong Lia'trông riêng của họ, cho một khoảng dừng trong ứng dụng của bạn (SDK 1.7).

// A results screen: a sponsored card docked under it.
const ad = await Lia.showNativeAd({ placement: "card" });
// The next round:
Lia.hideNativeAd();
Tùy chọnLoại
placementchuỗi"card" (mặc định): một thẻ nhỏ được gắn ở mép dưới, trang của bạn ngắn hơn để vừa, với nút đóng, cho đến khi nó'được đóng hoặc bạn gọi hideNativeAd(). Được giải quyết một khi nó'mà bật lên. "sheet": một quảng cáo lớn với hình ảnh hoặc video của nó, trong một tấm bìa trên ứng dụng của bạn, điều đó bị dừng lại (pause, sau đó resume) cho đến khi người dùng đóng nó. Giải quyết khi nó'được đóng.

Giải quyết với { shown: true, placement, height? } (height cho thẻ), hoặc { shown: false, reason } với reason một trong số no_ad, too_soon (quảng cáo nội bộ ít nhất một phút cách nhau cho mỗi người) và off.

Lỗi: bad_placement, và busy cho một bảng trong khi một bảng khác của Lia'bảng chia sẻ đang mở.

#Lia.hideNativeAd()

Loại bỏ thẻ gốc. Giải quyết với { hidden: true }.

#Lia.nativeAd

Quảng cáo bản địa hiện tại: { visible, placement, height }.

#Lia.onNativeAd(listener)

Nghe mỗi quảng cáo gốc'giai đoạn, { state, placement, height? }, với state một trong số "loading", "showing" và "closed" (cũng khi người dùng đóng thẻ). Trả về một hàm dừng lắng nghe. Giống như Lia.on("nativeAd", listener).

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

Nhập để tìm kiếm trên mọi trang, phương pháp và điểm cuối.