SDK справка

Lia.pay, Lia.charges и Lia.onCharge для Lia's pay sheet, Lia.showAd и его сокращения для полноэкранной рекламы, и Lia.showBanner и Lia.showNativeAd для баннеров и нативной рекламы.

#Платежи

Смотреть Платежи и список выплат как они работают, и Продать предмет для всего процесса.

#Lia.pay(productId, options)

Открывает Lia'платежная ведомость для одного из ваших продуктов. Решается, когда она'оплаченные; отклоняет, если это не'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 });

Решается с { chargeId, productId }. Затем отправьте chargeId к вашему серверу, чтобы доставить его.

Если страница перезагружается, пока таблица открыта, платеж поступает как "charge" событие вместо (см. Lia.onCharge).

#Ключи идемпотентности

С SDK 1.5, вызовы, которые что-то меняют (Lia.pay, Lia.inviteFriend, Lia.submitScore и облачное хранение'записи) пишут опциональный idempotencyKey. Тот же ключ, в течение 24 часов, не'не делайте это дважды: он отвечает так же, как первый вызов.

• Lia уже сохраняет каждый звонок один раз когда это повторяет его само (потеря соединения). Ваш собственный ключ добавляет ту же безопасность на вашей странице'ваше повторные попытки и перезагрузки: оставьте его (в Lia.deviceStorage, скажем) до тех пор, пока вызов не будет принят.
• Создавайте один ключ на действие (crypto.randomUUID() в порядке) и используйте его только для повторной попытки этой операции.
• Тот же ключ с разными аргументами отклоняется. Используйте новый ключ для новой операции.
• Для оплаты, платежная форма все равно открывается, чтобы человек мог подтвердить; подтверждение с ключом, который уже оплатил, возвращает первую оплату и не взимает дополнительных платежей.
• Приложение Lia старше SDK 1.5'ваше обновление игнорирует ключ, поэтому вызов все еще работает, просто без вашего ключа.

#Lia.charges()

Этот игрок'оплаченные платежи, которые ваш сервер не'не доставлено еще, старейшие сначала, до 50. Вызывайте его, когда ваше приложение открывается, и доставляйте любые, которые вы найдете.

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

Решается с массивом { chargeId, productId }.

#Lia.onCharge(listener)

Слушает заряд, который был подтвержден, когда не Lia.pay() ожидал, например, после перезагрузки. Слушатель получает { chargeId, productId }. Возвращает функцию, которая прекращает прослушивание. То же самое, что и Lia.on("charge", listener).

#Реклама

Смотреть Реклама для форматов, темпа и проверки на вашем сервере.

#Lia.showAd(options)

Показывает полноэкранный баннер над вашим приложением. Решается, когда он'закрыто.

const result = await Lia.showAd({ format: "rewarded" });
if (result.watched) giveReward(result.adId);

Решается с:

Ошибки: bad_format, busy. Не имея рекламы для показа, это не't ошибка: решается с reason: "no_ad".

#Lia.showRewardedAd(options)

То же самое Lia.showAd({ format: "rewarded", onState }). Видео, которое человек выбрал посмотреть.

#Lia.showRewardedInterstitialAd(options)

То же самое Lia.showAd({ format: "rewardedInterstitial", onState }). Lia сначала спрашивает человека, с Watch и Skip; Skip разрешается с reason: "skipped".

#Lia.showInterstitialAd(options)

То же самое Lia.showAd({ format: "interstitial", onState }). Тот, который использовать между раундами. Регулируется Lia (по умолчанию максимум один раз каждые 90 секунд и каждые 2nd запроса): когда он не'не наступило его время, оно сразу разрешается с shown: false, reason: "too_soon".

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

#Lia.onAd(listener)

Слушает каждый баннер'этапы, { state, format }, с state один из "loading", "showing" и "closed". Возвращает функцию, которая прекращает прослушивание. То же самое, что и Lia.on("ad", listener).

#Lia.showBanner(options)

Закрепляет адаптивный баннер на верхней или нижней кромке, рисуемый Lia вне вашей страницы. Ваша страница становится короче, чтобы вместить его, поэтому он никогда не перекрывает ничего (SDK 1.7). Решается, когда он'отображается, или один раз, когда Lia сдается (примерно 10 секунд).

const banner = await Lia.showBanner({ position: "bottom" });
if (banner.shown) console.log("Banner is", banner.height, "px");

Решается с { shown: true, position, height }, или { shown: false, reason } с reason один из no_ad (ни одного загруженного) и off (команда Lia отключила баннеры). Спросив снова для той же позиции, получает баннер уже вверху; спросив для другой позиции, перемещает его. AdMob обновляет его, пока он'вверх.

Ошибки: bad_position.

#Lia.hideBanner()

Убирает баннер; ваша страница получает обратно своё пространство. Возвращает { hidden: true }.

#Lia.banner

Текущий баннер: { visible, position, height } (position является null и height 0 когда там'нет). --lia-banner-height имеет ту же высоту, что и CSS переменная.

#Lia.onBanner(listener)

Слушает изменение баннера: { state, position, height, reason? }, с state один из "loading", "shown" (снова после обновления, которое изменило его высоту), "failed" и "hidden". Нижняя панель это "hidden" пока нативная карта занимает свое место, затем "loading" и "shown" снова. Возвращает функцию, которая прекращает слушание. То же самое, что и Lia.on("banner", listener).

#Lia.showNativeAd(options)

Нативная реклама в Lia'свой вид, для паузы в вашем приложении (SDK 1.7).

// A results screen: a sponsored card docked under it.
const ad = await Lia.showNativeAd({ placement: "card" });
// The next round:
Lia.hideNativeAd();

Решается с { shown: true, placement, height? } (height для карты), или { shown: false, reason } с reason один из no_ad, too_soon (натуральные объявления не менее минуты между каждым человеком) и off.

Ошибки: bad_placement, и busy для листа, пока другой из Lia'дольки открыты.

#Lia.hideNativeAd()

Убирает нативную карточку. Возвращает { hidden: true }.

#Lia.nativeAd

Нативная реклама сейчас: { visible, placement, height }.

#Lia.onNativeAd(listener)

Слушает каждый нативный баннер'этапы, { state, placement, height? }, с state один из "loading", "showing" и "closed" (также когда человек закрывает карту). Возвращает функцию, которая прекращает прослушивание. То же самое, что и Lia.on("nativeAd", listener).

Автоматически переведено. Английский — источник истины. Читать на английском