SDK reference

Payments and ads

Kopya ang pahina

Lia.pay, Lia.charges at Lia.onCharge para sa pay sheet ng Lia, Lia.showAd at ang mga shortcut nito para sa full screen ads, at Lia.showBanner at Lia.showNativeAd para sa banners at native ads.

#Payments

Tingnan Payments and the pay sheet para sa kung paano sila gumagana, at Bilhin ang isang item para sa buong flow.

#Lia.pay(productId, options)

Nakakabukas Lia'ang pay sheet ay buksan'ang iyong params at sagot, at bawat event'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 });

Parameter	Uri
`productId`	string	Isang produkto mo' ids, hanggang 64 characters.
`options.idempotencyKey`	string	Pangkatawan, 1 hanggang 64 ng mga letra, digit, `_`, `-`, `.` at `:`. Tingnan Mga idempotency keys.

Nag-uugnay sa { chargeId, productId }. Pagkatapos ipadala ang chargeId sa iyong server para ipadala ito.

Error	Kailan
`cancelled`	Ang tao ay sarado ang sheet nang walang pagbabayad.
`no_product`	Wala pang aktibong produkto na may ganitong id.
`busy`	Isa pang Lia's screens ay bukas sa ibabaw ng iyong app.
`bad_productId`	Ang id ay hindi'hindi maaabot teksto hanggang 64 mga karakter.
`bad_idempotency_key`	Ang pana ay hindi'hindi nasa tamang anyo.
`not_ready`, `not_in_lia`	Lia ay di kaya'hindi maaabot handa, o ito ay hindi't Lia.

Kung ang pahina ay nag-reload habang ang sheet ay bukas, ang pagbili ay dumating bilang isang "charge" event sa halip (tingnan ang Lia.onCharge).

#Mga idempotency keys

Mula sa SDK 1.5, ang mga tawag na nagbabago ng bagay (Lia.pay, Lia.inviteFriend, Lia.submitScore at cloud storage'ang mga isulat) ay naglalaman ng isang opsyonal idempotencyKey. Ang parehong key muli, sa loob ng 24 oras, ay'gawin ito dalawang beses: sumagot ito tulad ng unang pagtawag.

Lia ay nagsa-save na ng bawat tawag kapag ito ay naisip nito mismo (isang nawalang koneksi). Ang iyong sariling key ay idinagdag ang parehong seguridad sa buong pahina mo's retries at reloads: panatilihin ito (sa Lia.deviceStorage, sabi) hanggang ang tawag ay tinanggap.
Gawin ang bawat isa na may kaukulang puso (crypto.randomUUID() ay okay) at gamitin muli lamang para i-retry ang aksyon na iyon.
Ang pareho na key na may iba't ibang argumento ay tinanggihan. Gamitin ang bagong key para sa bagong aksyon.
Para sa isang pagbabayad, ang pay sheet ay patuloy na buksan para sa tao upang i-verify; ang pag-verify gamit ang isang key na naka-charge na nanguna ay magbibigay ng unang charge at walang karagdagang bayad.
Isang app ng Lia na mas bata kaysa sa SDK 1.5's release ignore ang key, kaya ang tawag ay patuloy na gumagana, lamang na walang iyong key.

#Lia.charges()

Ang manlalaro's mga bayad na nagkakahalaga ng iyong server ay hindi'hindi pa ipinadala, pinaka-bata muna, hanggang 50. I-call ito kapag ang iyong app ay buksan, at ipadala anumang nakita mo.

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

Nag-uugnay sa isang array ng { chargeId, productId }.

#Lia.onCharge(listener)

Nakikinig sa isang pagbili na pinatunayan habang walang Lia.pay() ay naghihintay para dito, tulad ng pagkatapos ng isang reload. Ang tagasubaybay ay nakatanggap ng { chargeId, productId }. Babalik ang isang function na tumigil sa pagpakinig. Ang pareho ay Lia.on("charge", listener).

#Mga ad

Tingnan Mga ad para sa mga format, pacing at pag-check sa iyong server.

#Lia.showAd(options)

Naglalaro ng isang buong screen na ad sa loob ng iyong app. Naresolba ito kapag ito'na naka-close.

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

Pamilihan	Uri
`format`	string	`"rewarded"` (ang default), `"rewardedInterstitial"` o `"interstitial"`.
`onState`	function	Pangkatawan. Nakikinig sa bawat yugto: `"loading"`, `"showing"`, `"closed"`.

Nag-uugnay sa:

Kampo	Uri
`watched`	boolean	Isang rewarded ad ay pinanood hanggang sa dulo.
`shown`	boolean	Nag-appear ang isang ad sa screen.
`adId`	string	Nakikita kapag `watched` ay true, at kapag isang interstitial ay ipinakita. Suriin ito sa iyong server gamit `POST /ads/verify`.
`reason`	string	Kailan `watched` ay false: `cancelled`, `skipped`, `no_ad`, `too_soon`, `failed` o isang problema sa koneksi.

Mga error: bad_format, busy. Walang ad na ipakita ay't isang error: nag-uugnay sa reason: "no_ad".

#Lia.showRewardedAd(options)

Ang pareho tulad ng Lia.showAd({ format: "rewarded", onState }). Isang video na pinili ng tao na manood.

#Lia.showRewardedInterstitialAd(options)

Ang pareho tulad ng Lia.showAd({ format: "rewardedInterstitial", onState }). Lia muna ang humihingi ng tao, kasama ang Watch at Skip; Skip ay nagsasagot sa reason: "skipped".

#Lia.showInterstitialAd(options)

Ang pareho tulad ng Lia.showAd({ format: "interstitial", onState }). Ang isa na gagamitin sa pagitan ng mga round. Paced by Lia (sa default ay isang beses kada 90 segundo at bawat 2nd ask): kapag ito ay'hindi pa ang kanyang pagkakataon, ito ay naglulutas agad na may shown: false, reason: "too_soon".

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

#Lia.onAd(listener)

Nakikinig sa bawat ad'ang stages, { state, format }, kasama state isa sa "loading", "showing" at "closed". Babalik ang isang function na tumigil sa pagpakinig. Ang pareho ay Lia.on("ad", listener).

#Lia.showBanner(options)

Nakadock ang isang adaptive banner sa itaas o sa ilalim na gilid, na dinisenyo ng Lia labas ng iyong pahina. Ang iyong pahina ay mas maikli upang magkasya ito, kaya ito ay hindi kailanman nakakasalubong sa anumang bagay (SDK 1.7). Nagsisimula ito pagkatapos na ito'ang ipinakita, o isang beses kung ang Lia ay sumuko (tungkol sa 10 segundo).

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

Pamilihan	Uri
`position`	string	`"bottom"` (ang default) o `"top"`. Sa fullscreen, isang top banner ay nasa ilalim ng Lia'ang floating Close at ⋯.

Nag-uugnay sa { shown: true, position, height }, o isang ref o getter ( { shown: false, reason } kasama reason isa sa no_ad (wala pa nakalagay) at off (ang Lia team ay inilagay ang banners off). Pagtanong muli para sa parehong posisyon ay magbibigay ng banner na nasa itaas na; pagtanong para sa iba pang posisyon ay maglilipat nito. AdMob ay i-refresh ito habang ito'nagbubukas.

Mga error: bad_position.

#Lia.hideBanner()

Kumukuha ng banner; ang iyong pahina ay nakakakuha ng kanyang puwesto ulit. Nag-uugnay sa { hidden: true }.

Ang banner ngayon: { visible, position, height } (position ay null at height 0 kapag doon'wala). --lia-banner-height nagmamay-ari ang parehong height bilang isang CSS variable.

#Lia.onBanner(listener)

Nakikinig sa pagbabago ng banner: { state, position, height, reason? }, kasama state isa sa "loading", "shown" (mulang pag-refresh na nagbago ang kanyang height), "failed" at "hidden". Isang bottom banner ay "hidden" habang ang isang native card ay kumakatawan dito, pagkatapos "loading" at "shown" ulit. Babalik ang isang function na nagpapahinto sa pagpakinig. Ang pareho ay Lia.on("banner", listener).

#Lia.showNativeAd(options)

Isang native ad sa Lia'naka-own look, para sa isang pagpahinto sa iyong app (SDK 1.7).

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

Pamilihan	Uri
`placement`	string	`"card"` (ang default): isang compact card na naka-dock sa ilalim na edge, ang iyong pahina ay mas maikli para makasunod, may isang close button, hanggang sa ito'na naka-close o kung ikaw ay tumawag `hideNativeAd()`. Nagsasagot nang magkakasunod ito'nagbubukas. `"sheet"`: isang mas malaking ad na may kanyang larawan o video, sa isang sheet sa ibabaw ng iyong app, na naka-pause (`pause`, pagkatapos `resume`) hanggang ang tao ay isara ito. Matapos ito ang resolve'na naka-close.

Nag-uugnay sa { shown: true, placement, height? } (height para sa card), o { shown: false, reason } kasama reason isa sa no_ad, too_soon (native ads ay kailangang isang minuto ang pagitan para sa bawat tao) at off.

Mga error: bad_placement, at busy para sa isang sheet habang ang iba pang Lia'ang sheets ay bukas.

#Lia.hideNativeAd()

Kumukuha ng native card. Nag-uugnay sa { hidden: true }.

#Lia.nativeAd

Ang native ad ngayon: { visible, placement, height }.

#Lia.onNativeAd(listener)

Nakikinig sa bawat native ad'ang stages, { state, placement, height? }, kasama state isa sa "loading", "showing" at "closed" (din kung ang tao ay nagsara ng card). Nagbabalik ng isang function na humihinto sa pagpakinig. Ang pareho na Lia.on("nativeAd", listener).

Awtomatikong isinalin. Ang English ay ang source of truth. Basahin sa Ingles