Referência SDK
Início e ciclo de vida
Copiar página
Lia.init, Lia.ready, Lia.session e Lia.close, e cada evento Lia envia para sua página.
#Lia.init()
Chame primeiro. Ele responde com quem é o jogador e tudo sobre como seu app é exibido, e preenche o SDK's propriedades e CSS variáveis.
const me = await Lia.init();Resolve com:
| Campo | Tipo | O que ele é |
|---|---|---|
player | objeto | { id, name }: o jogador'id no seu app, e seu nome de usuário Lia. Veja Jogadores. |
session | string | Um token de sessão para o seu servidor, lias_…. |
exp | número | Quando a sessão terminar, em milissegundos desde 1970 (15 minutos após a abertura). |
mode | string | "test" ou "live". |
language | string | A pessoa's idioma em Lia: "en". |
rtl | booleano | Se ele é lido da direita para a esquerda. |
platform | string | "ios" ou "android". |
theme | string | "light" ou "dark". |
themeParams | objeto | Lia'cores (bg_color, text_color…). |
display | string | "sheet", "full" ou "fullscreen". |
isFullscreen | booleano | De borda a borda ou não. |
viewport | objeto | { height, expanded } |
safeArea | objeto | { top, bottom, left, right } em px |
contentSafeArea | objeto | { top, bottom, left, right } em px |
startParam | string ou nulo | O que seu app foi aberto com. |
link | string | Seu app's link de convite, sem um startParam. |
sound | booleano | Se a pessoa quer seu aplicativo'sons. |
notifications | objeto | { allowed, available }: se eles permitiram suas notificações, e se seu app pode perguntar. |
Erros: not_in_lia, not_ready (Lia ainda está abrindo o aplicativo; tente novamente em breve), timeout.
#Lia.ready()
Diz Lia que sua página foi desenhada, então ela retira seu carregador. Chame-a uma vez que sua primeira tela esteja na página. Retorna nada.
Lia.init().then(function (me) {
renderHome(me);
Lia.ready();
});#Lia.session()
Um token de sessão fresco para o seu servidor. Sessões duram 15 minutos, então obtenha um novo antes das chamadas que seu servidor deve confiar.
const { session, exp } = await Lia.session();Resolve com { session, exp }. Erros: not_open (a pessoa não'abriu seu app no Lia ainda; chame init() primeiro), timeout.
#Lia.close()
Fecha seu aplicativo. Resolve com null. Se você ativou confirmação de fechamento, isso se fecha sem perguntar.
#Lia.on(event, listener)
Escuta um dos Lia'eventos. Retorna uma função que para de escutar.
const stop = Lia.on("theme", function (data) { redraw(data.colorScheme); });
// later
stop();Lançamentos bad_listener se listener não't uma função. Um ouvinte que lança não'para parar os outros.
#Lia.off(event, listener)
Para de ouvir um ouvinte adicionado com Lia.on.
#Lia.onPause(listener)
O mesmo que Lia.on("pause", listener). Retorna uma função que para de ouvir.
#Lia.onResume(listener)
O mesmo que Lia.on("resume", listener).
#Eventos
| Evento | Dados | Quando |
|---|---|---|
"pause" | nenhum | Lia foi para o plano de fundo, ou um dos Lia'telas (a folha de pagamento, um anúncio, um diálogo) cobrem seu aplicativo. Pausar os cronômetros e o som. |
"resume" | nenhum | De volta novamente. |
"theme" | { theme, colorScheme } | A pessoa alterou Lia entre claro e escuro. theme são os novos cores. As variáveis CSS já foram atualizadas. |
"viewport" | { height, expanded, isStateStable } | Sua página'altura mudou (uma folha puxada, botões de baixo mostrados). |
"fullscreenChanged" | { isFullscreen, contentSafeArea } | Seu app foi para ou da tela cheia. |
"languageChanged" | { language, rtl } | A pessoa alterou Lia's idioma. |
"startParam" | { startParam } | Uma notificação ou convite para o seu app foi aberto enquanto ele já estava aberto. |
"notificationsChanged" | { allowed } | A pessoa permitiu ou bloqueou seu aplicativo's notificações. |
"soundChanged" | { on } | A pessoa mutou ou desmutou seu aplicativo de Lia'menu ⋯. |
"charge" | { chargeId, productId } | Um pagamento foi confirmado enquanto não Lia.pay() estava esperando (após uma recarregamento). Também Lia.onCharge. |
"ad" | { state, format } | Um anúncio'estágio: "loading", "showing" ou "closed". Também Lia.onAd. |
"banner" | { state, position, height, reason? } | O banner's "loading", "shown", "failed" ou "hidden". Também Lia.onBanner. |
"nativeAd" | { state, placement, height? } | Um anúncio nativo's "loading", "showing" ou "closed". Também Lia.onNativeAd. |
"safeAreaChanged" | { safeArea, contentSafeArea } | Um banner fixado ou cartão nativo tomou ou devolveu uma borda: Lia põe espaço ao redor dele, então sua área segura ali é 0. CSS as variáveis já estão atualizadas. |
"mainButtonClicked" | nenhum | O botão principal foi pressionado. Também Lia.mainButton.onClick. |
"secondaryButtonClicked" | nenhum | O segundo botão foi pressionado. |
"backButtonClicked" | nenhum | O cabeçalho's botão de voltar foi pressionado. |
"settingsButtonClicked" | nenhum | Configurações foram escolhidas no menu ⋯. |
"accelerometerChanged" | { x, y, z } | Uma leitura, enquanto o acelerômetro roda. |
"gyroscopeChanged" | { x, y, z } | Uma leitura, enquanto o giroscópio roda. |
"deviceOrientationChanged" | { alpha, beta, gamma } | Uma leitura, enquanto a orientação roda. |
"accelerometerStarted", "accelerometerStopped" | nenhum | O sensor começou ou parou. Também para gyroscope e deviceOrientation. |
O SDK atualiza suas próprias propriedades (Lia.colorScheme, Lia.viewport, Lia.language, Lia.soundOn e o restante) antes que seus ouvintes saiam.
Traduzido automaticamente. O inglês é a fonte de verdade. Leia em inglês