Conceitos

Sua página roda em um quadro bloqueado dentro do app Lia e alcança Lia apenas através do SDK. Os três aspectos, o cabeçalho e o menu de Lia, e as regras sob as quais sua página roda.

#O quadro

Quando alguém abre seu aplicativo, Lia pergunta ao seu servidor se ele pode (ver Teste e live), faz com que eles entrem como jogadores do seu app, e carrega sua página em um quadro dentro do app Lia. Sua página é uma página da web normal: qualquer framework, qualquer host, servida por https.

O quadro está bloqueado para que as pessoas possam confiar em todos os aplicativos em Lia:

• Apenas as suas próprias páginas são carregadas. O quadro permanece no seu aplicativo's origem (seu esquema, host e porta). Um link ou redirecionamento para qualquer outro site é bloqueado. Abra outros sites com Lia.openLink.
• Sua página ainda pode buscar. Scripts, imagens, fontes e fetch() chamadas para outros endereços funcionam como na web (com CORS, como de costume).
• Nenhum popups ou novas janelas, sem câmera, microfone ou localização, e sem pagamentos próprios. Dinheiro, anúncios e qualquer coisa no telefone acontecem em Lia'seu próprio telas sobre seu app.
• Lia só ouve sua página no quadro superior. Chamadas SDK de um iframe dentro da sua página, ou de uma página de outra origem, são ignoradas.
• Mensagens são pequenas e espaçadas. Uma chamada com mais de 16,000 caracteres é ignorada (e expira). Mais de 20 chamadas em um segundo são recusadas com slow_down.

Lia'frame relata LiaApps/1 no final do agente de usuário, se você quiser reconhecê-lo no seu servidor.

#O puente

O SDK se comunica com Lia através do quadro's bridge. Cada chamada que sua página faz é uma mensagem com um id; Lia responde a ela uma vez, e o SDK transforma isso em uma promessa. Lia também envia eventos (o tema mudou, o app foi pausado) que você escuta com Lia.on.

Chamadas que aguardam a pessoa (a folha de pagamento, um anúncio, o scanner, Face ID, um diálogo) não têm limite de tempo. Todas as outras chamadas falham com timeout se Lia não't respondido dentro de 20 segundos. Fora do app Lia não há ponte, e cada chamada falha com not_in_lia.

#Três aparências

Cada aplicativo abre em um dos três estilos, definido pela equipe Lia para o seu aplicativo. Sua página pode alternar entre eles com o SDK.

Lia.display diz como seu app foi aberto, e Lia.isFullscreen se ele'borda a borda agora mesmo. Lia.requestFullscreen() e Lia.exitFullscreen() mudar para e de tela cheia.

#Lia'cabeçalho e menu

Em sheet e full, Lia desenha um cabeçalho sobre sua página: seu app'ícone e nome (e Teste com seu nome de desenvolvedor durante o teste), um menu e Fechar. Você pode pinte-o e mostre um botão de voltar nele.

O menu ⋯ sempre tem:

• Configurações, quando sua página mostrar Lia.settingsButton.
• Notificações ligadas ou desligadas, quando seu app pode enviá-los (veja Notificações).
• Mutar ou desmutar sons, que seu página ouve como soundChanged.
• Recarregar e Fechar.

#Enquanto sua página carrega

Lia mostra seu próprio carregador sobre seu app desde o momento em que abre até que sua página chame Lia.ready() (ou termina de carregar). Chame-o assim que a primeira tela for desenhada. Se sua página falhar em carregar, Lia mostra uma mensagem com Tente novamente.

#Pausar e retomar

Sua página ouve pause quando Lia vai para o plano de fundo ou cobre seu app com uma de suas próprias telas (a planilha de pagamento, um anúncio, um diálogo, o scanner), e resume quando ele's fundo. Pausar temporizadores, música e loops de jogo em pause. Veja Ciclo de vida e eventos.

#Uma planilha por vez

Lia mostra uma de suas próprias telas sobre seu app por vez. Enquanto a planilha de pagamento, um anúncio, um diálogo, o seletor de amigos, a pergunta de notificações, o scanner ou o Face ID estiver aberto, outra chamada como essa falha com busy.

#Quem pode abrir seu app

• Pessoas precisam de um Lia nome de usuário para abrir qualquer app.
• Enquanto seu aplicativo estiver em testar, apenas você e seus testadores podem abri-lo. Quando ele's ao vivo, todos podem. Quando ele's pausado, ninguém pode. Veja Teste e live.
• Se a equipe Lia definir um estouro mínimo para o seu app, as pessoas precisam de uma sequência de check-in tão longa para abri-lo. Lia mostra como chegar lá.

Traduzido automaticamente. O inglês é a fonte de verdade. Leia em inglês