Konsepto

Ang iyong pahina ay tumatakbo sa isang nakalock na frame sa loob ng app na Lia at nakakadiretso sa Lia lamang sa pamamagitan ng SDK. Ang tatlong hitsura, ang header at menu ng Lia, at ang mga patakaran kung saan ang iyong pahina ay tumatakbo.

#Ang frame

Kapag ang isang tao buksan ang iyong app, ang Lia humihingi sa kanyang server kung maaari ito (tingnan Pagsusulit at live), nag-sign in bilang isang player ng iyong app, at nag-load ng iyong pahina sa isang frame sa loob ng Lia app. Ang iyong pahina ay isang normal na web page: anumang framework, anumang host, na inilulunsad sa pamamagitan ng https.

Ang frame ay naka-lock up para ang mga tao ay makapag-ibig sa bawat app sa Lia:

• Nakakabukas lamang ang iyong sariling mga pahina. Ang frame ay nananatili sa iyong app'naka-bukas ang origin (ang kanyang scheme, host at port). Ang isang link o redirect sa anumang iba pang site ay i-block. Buksan ang iba pang mga site gamit Lia.openLink.
• Ang iyong pahina ay maaaring magbawi pa rin. Mga script, imahe, font at fetch() mga tawag sa iba pang mga address ay gumagana tulad ng sa web (kasama ang CORS, tulad ng karaniwan).
• Wala pang popups o bagong window, walang kamera, mikropono o lokasyon, at walang mga pagbabayad ng iyong sarili. Ang pera, mga ad at anumang bagay sa telepono ay nangyayari sa Lia'ang sariling screens sa ibabaw ng iyong app.
• Lia lamang ang nakikinig sa iyong pahina sa pinakamataas na frame. SDK mga tawag mula sa isang iframe sa loob ng iyong pahina, o mula sa isang pahina sa ibang origin, ay inignora.
• Ang mga mensahe ay maliit at may tamang bilis. Isang tawag na higit sa 16,000 karakter ay ikinikilala (at tumatagal). Higit sa 20 tawag sa isang segundo ay tinatanggihan na may slow_down.

Lia'ang frame ay nag-uulat LiaApps/1 sa dulo ng kanyang user agent, kung nais mo itong makilala sa iyong server.

#Ang bridge

Ang SDK nakikipag-usap sa Lia sa pamamagitan ng frame'na bridge. Ang bawat pagtawag na ginawa ng iyong pahina ay isang mensahe na may id; Lia ang sumagot nito, at ang SDK ay nagbabago nito sa isang pangako. Lia din ang nagpapadala ng mga event (ang tema ay nagbago, ang app ay naka-pause) na kailangan mong marinig gamit Lia.on.

Mga tawag na naghihintay sa tao (ang pay sheet, isang ad, ang scanner, Face ID, isang dialog) walang limitasyon sa oras. Ang anumang iba pang tawag ay nabigo sa timeout kung Lia ay hindi't sagot sa loob ng 20 segundo. Sa labas ng app na Lia walang bridge, at ang bawat tawag ay nabigo sa not_in_lia.

#Tatlong hitsura

Ang bawat app ay bukas sa isang sa tatlong hitsura, na itinakda ng Lia na koponan para sa iyong app. Ang iyong pahina ay maaaring magbago sa pagitan ng mga ito gamit ang SDK.

Lia.display sabi kung paano ang app mo ay buksan, at Lia.isFullscreen kung ito'ang edge to edge ngayon. Lia.requestFullscreen() at Lia.exitFullscreen() magbago at mula sa fullscreen.

#Lia'ng header at menu

Sa sheet at full, Lia gumuhit ng isang header sa ibabaw ng iyong pahina: ang iyong app's icon at pangalan (at Pagsusulit kasama ang iyong pangalan ng developer habang nasa test), isang menu at Close. Maaari mo ilakip ito at ipakita ang isang back button sa kanya.

Ang menu na ⋯ ay palaging may:

• Mga setting, kung kailan ang iyong pahina ay ipapakita Lia.settingsButton.
• On o off na notification, kung kailan ang iyong app ay maaaring magpadala nila (tingnan ang Mga Notification).
• I-mute o i-unmute ang mga tunog, na narinig ng iyong pahina bilang soundChanged.
• I-reload at Isara.

#Habang ang iyong pahina ay naglo-load

Lia ay ipapakita ang kanyang sariling loader sa ibabaw ng iyong app mula nang ito ay buksan hanggang sa ang iyong pahina ay tumawag Lia.ready() (o matapos mag-load). Tawagan ito agad ang unang screen ay naka-display. Kung ang iyong pahina ay hindi nakaloload, Lia ay ipapakita ang mensahe na Try again.

#Pumigil at muling simulan

Ang iyong pahina ay nakikinig pause kapag Lia ay pumunta sa background o naka-cover ang iyong app sa isang screen nito (ang pay sheet, isang ad, isang dialog, ang scanner), at resume kapag ito'na pindutan ng back. I-pause ang mga timer, musika at game loops sa pause. Tingnan Lifecycle at mga event.

#Isang sheet sa isang pagkakataon

Lia ay ipapakita ang isang sariling screen sa ibabaw ng iyong app sa isang oras. Samantalang ang pay sheet, isang ad, isang dialog, ang friend picker, ang mga katanungan sa notification, ang scanner o Face ID ay bukas, ang isa pang ganitong tawag ay nabigo na may busy.

#Sino ang maaaring buksan ang iyong app

• Ang mga tao ay kailangan ng Lia username upang buksan anumang app.
• Habang ang iyong app ay nasa pagsusulit, o's live, lahat ay maaaring gawin. Kapag ito's nagtatanggal, walang sinomano. Tingnan Pagsusulit at live.
• Kung ang koponan ng Lia ay nagtakda ng isang minimum streak para sa iyong app, kailangan ng isang check-in streak na mahaba upang buksan ito. Lia ipakita sa kanila kung paano makarating doon.

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