Referência SDK
Notificações, convites e o lobby
Copiar página
Lia.requestNotifications, Lia.inviteFriend, Lia.inviteLink, Lia.share e Lia.lobby.
#Notificações
Seu servidor envia notificações com POST /notifications. Sua página pede apenas permissão. Veja Notificações.
#Lia.requestNotifications()
Pergunta à pessoa, em Lia'seu próprio folha de pagamento, para permitir que seu app envie notificações a eles. Se eles já fizeram, ele responde imediatamente sem perguntar.
const { allowed } = await Lia.requestNotifications();Resolve com { allowed }. Lia.notificationsAllowed também é atualizado.
| Erro | Quando |
|---|---|
notifications_off | Seu app pode não enviar notificações (a equipe Lia desativou-as para ele). |
busy | Outro de Lia'telas estão abertas. |
#Convites
Ver Convites e links.
#Lia.inviteFriend(options)
Abre Lia'seletor de amigos. Cada amigo selecionado recebe um cartão em seu Lia chat que abre seu app com seu startParam. A folha também permite que a pessoa compartilhe seu link de convite em qualquer lugar.
const { invited } = await Lia.inviteFriend({ startParam: "room-k3x9" });| Opção | Tipo | |
|---|---|---|
startParam | string | Opcional. 1 a 64 de letras, dígitos, _ e -. |
idempotencyKey | string | Opcional (SDK 1.5). Com a mesma chave, cada amigo recebe esse convite'carta uma vez. Veja Chaves de idempotência. |
Resolve com { invited }: true uma vez que alguém foi convidado ou o link foi compartilhado. Seu app nunca descobre quem.
Erros: bad_start_param, bad_idempotency_key, busy.
#Lia.inviteLink(startParam)
Seu app'com marca lialabs.app link de lançamento, com um startParam opcional. Qualquer pessoa pode abri-lo: com Lia, ele abre seu aplicativo com o startParam; sem ele, aponta para a App Store. Chame-o após Lia.init().
const link = Lia.inviteLink("room-k3x9");
// "https://your-app.lialabs.app/play?start=room-k3x9"Retorna uma string (não uma promessa). Lança not_ready antes init() respondeu, e bad_start_param para um startParam que não'não caber.
#Lia.share(text)
Abre o telefone'folha de compartilhamento com seu texto, para qualquer aplicativo no telefone. Resolve com null uma vez que a planilha for fechada.
await Lia.share("I scored 1280 in Tilt Runner. Beat me: " + Lia.inviteLink());| Parâmetro | Tipo | |
|---|---|---|
text | string | Até 500 caracteres. |
Erros: bad_text.
#O salão de espera
Mesas públicas que qualquer um em Lia pode encontrar (SDK 1.6). Seu servidor lista e senta-os; veja Mesas públicas.
#Lia.lobby
#Lia.lobby.tables(options)
As mesas abertas no seu aplicativo, em ordem crescente. Nunca o jogador'seu próprio tabelas, tabelas completas ou expiradas, ou as de qualquer um que eles bloquearam ou que os bloqueou.
const { tables, next } = await Lia.lobby.tables({ stake: 5 });
// [{ id: "t8k2d", game: "your-app", host: { name: "amara" }, seats: 2, taken: 1, title: "Quick game", stake: 5, pot: 0, createdAt, expiresAt }]
const more = next ? await Lia.lobby.tables({ stake: 5, cursor: next }) : null;| Opção | Tipo | |
|---|---|---|
stake | número | Opcional. Apenas mesas nesse stake, em LIA (0 para os gratuitos). |
cursor | string | Opcional. next da página anterior. |
limit | número | Opcional. 1 a 50, 20 por padrão. |
Resolve com { tables, next }: next é o cursor para mais, ou null. Cada tabela:
| Campo | Tipo | |
|---|---|---|
id | string | A tabela'id, conforme listado pelo seu servidor. |
game | string | Seu app'id. |
host | objeto | { name }: o host'no Lia nome de usuário. |
seats, taken | número | Assentos totais, e ocupados (o anfitrião's incluídos). |
title | string ou nulo | Até 40 caracteres. |
stake, pot | número | Em LIA, declare os globais até que haja |
createdAt, expiresAt | número | Milissegundos desde 1970. |
Para sentar, envie a mesa's id para o seu servidor, que senta o jogador com POST /lobby/tables/:id/sit. Alguém que escolheu sua mesa em Lia'seu próprio lobby chega com Lia.startParam definido para lobby-<table id>: sente-os da mesma forma.
Erros: bad_stake, bad_cursor, bad_session (a sessão não'não seja renovado), not_in_lia.
#Lia.lobby.report(playerId, reason, options)
Relata um jogador para a equipe Lia. Eles're também está bloqueado para a pessoa que relata, então nenhum dos dois vê o outro'tabelas novamente.
await Lia.lobby.report("p_3f9c0a6d1b2e4f5a6b7c", "unfair", { tableId: "t8k2d", note: "Left every game when losing" });| Parâmetro | Tipo | |
|---|---|---|
playerId | string | O jogador'id no seu app. |
reason | string | "name", "unfair", "abuse" ou "other". |
options.tableId | string | Opcional. A mesa em que isso aconteceu. |
options.note | string | Opcional, até 300 caracteres. |
Resolve com { reported: true }. Erros: bad_reason, unknown_player, slow_down (mais de 20 relatórios por dia), bad_note, bad_tableId.
Traduzido automaticamente. O inglês é a fonte de verdade. Leia em inglês