SDK reference

Mga Notification, mga panawag at ang lobby

Kopya ang pahina

Lia.requestNotifications, Lia.inviteFriend, Lia.inviteLink, Lia.share at Lia.lobby.

#Mga Notification

Ang iyong server ay nagpapadala ng mga notification gamit ang POST /notifications. Ang iyong pahina ay nangangailangan lamang ng pahintulot. Tingnan ang Mga Notification.

#Lia.requestNotifications()

Nagtanong sa tao, sa Lia'ang sariling sheet.

const { allowed } = await Lia.requestNotifications();

Nag-uugnay sa { allowed }. Lia.notificationsAllowed ay dinagdagan din.

Error	Kailan
`notifications_off`	Ang iyong app ay maaaring hindi magpadala ng mga notification (ang Lia team ay inilagay ito sa off para dito).
`busy`	Isa pang Lia's screens ay bukas.

#Mga pag-invite

Tingnan Mga pag-invite at link.

#Lia.inviteFriend(options)

Nakakabukas Lia'ang friend picker. Ang bawat kaibigan na pinili ay makakatanggap ng isang card sa kanilang Lia chat na buksan ang iyong app na may iyong startParam. Ang sheet ay nagbibigay din ng pagkakataon para magbahagi ang tao ng iyong link sa pagtawag sa anumang lugar.

const { invited } = await Lia.inviteFriend({ startParam: "room-k3x9" });

Pamilihan	Uri
`startParam`	string	Pangkatawan. 1 hanggang 64 ng mga letra, digit, `_` at `-`.
`idempotencyKey`	string	Pangkatawan (SDK 1.5). May parehong key, ang bawat kaibigan ay nakakatanggap ng panata'na card isang beses. Tingnan Mga idempotency keys.

Nag-uugnay sa { invited }: true isang beses na ang sinuman ay inirerekta o ang link ay ibinahagi. Ang iyong app ay walang alam kung sino ang.

Mga error: bad_start_param, bad_idempotency_key, busy.

#Lia.inviteLink(startParam)

Ang iyong app's invite link, na may opsyonal na startParam. Ang sinuman ay maaaring buksan ito: kasama ang Lia, ito buksan ang iyong app na may startParam; walang ito, ito tumuturo sa App Store. Tawagan ito pagkatapos Lia.init().

const link = Lia.inviteLink("room-k3x9");
// "https://api.lialabs.org/play/your-app?start=room-k3x9"

Nagbabalik ng isang string (hindi isang pangako). Nag-uulat not_ready bago init() nag-utos, at bad_start_param para sa isang startParam na hindi'hindi magkasya.

Nakakabukas ang phone'ang share sheet na may iyong teksto, para sa anumang app sa telepono. Nagreresolba ito sa null isang beses na ang sheet ay sarado.

await Lia.share("I scored 1280 in Tilt Runner. Beat me: " + Lia.inviteLink());

Parameter	Uri
`text`	string	Hanggang sa 500 mga karakter.

Mga error: bad_text.

#Ang lobby

Pangkabahayan na mga mesa na maaaring mahanap ng sinuman sa Lia (SDK 1.6). Ang iyong server ay nag-lista at nag-uupo dito; tingnan Pangkabahayan na mga mesa.

#Lia.lobby

#Lia.lobby.tables(options)

Ang mga bukas na table sa iyong app, pinakabago unang. Hindi kailanman ang manlalaro'ang sariling view).

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;

Pamilihan	Uri
`stake`	bilang	Opisyal. Ang mga table lamang dito, sa LIA (`0` para sa libreng mga bagay).
`cursor`	string	Pangkatawan. `next` mula sa pahina bago ito.
`limit`	bilang	Pangkatawan. 1 hanggang 50, 20 nang default.

Nag-uugnay sa { tables, next }: next ay ang cursor para sa higit pa, o null. Bawat table:

Kampo	Uri
`id`	string	Ang talahanayan'ng id, para sa iyong server na suriin. Ipakita kapag
`game`	string	Ang iyong app'ng in
`host`	object	`{ name }`: ang host's Lia username.
`seats`, `taken`	bilang	Kabuuang upuan, at kinuha (ang host's kasama).
`title`	string o null	Hanggang sa 40 mga karakter.
`stake`, `pot`	bilang	Sa LIA, bilang ang iyong server ay natala (para sa ipakita).
`createdAt`, `expiresAt`	bilang	Mili segundo mula 1970.

Upang umupo, ipadala ang mesa's id sa iyong server, na nagse-seat ng manlalaro na may POST /lobby/tables/:id/sit. Isang tao na pumili ng iyong table sa Lia'naka-own lobby dumating na may Lia.startParam naka-ayos sa lobby-<table id>: ilagay sila nang pareho.

Mga error: bad_stake, bad_cursor, bad_session (ang sesyon ay wala't muling ipares, not_in_lia.

#Lia.lobby.report(playerId, reason, options)

Nag-uulat ng isang manlalaro sa Lia na koponan. Sila'din blokeado para sa tao na nag-uulat, kaya wala sila ang isa't isa nakikita'ulit ang mga table.

await Lia.lobby.report("p_3f9c0a6d1b2e4f5a6b7c", "unfair", { tableId: "t8k2d", note: "Left every game when losing" });

Parameter	Uri
`playerId`	string	Ang manlalaro'ng id sa iyong app. Nananatili ito pareho tuwing sila ito buksan, sa anumang telepono. Ito
`reason`	string	`"name"`, `"unfair"`, `"abuse"` o `"other"`.
`options.tableId`	string	Opisyal. Ang mesa kung saan nangyari ito.
`options.note`	string	Pangkatawan, hanggang 300 mga karakter.

Nag-uugnay sa { reported: true }. Mga error: bad_reason, unknown_player, slow_down (higit sa 20 ulat sa isang araw), bad_note, bad_tableId.

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

Mga Notification, mga panawag at ang lobby