Téléphone et apparence

import { phone, appearance } from "@aicore-fivem/lib/server";

phoneCopy Anchor Link

Le téléphone du joueur via ai-core : le premier script de téléphone qui tourne (tgiann-phone, lb-phone...) répond. Sans script de téléphone, chaque appel répond null ou false. Les équivalents Lua sur aiLib.phone ont les mêmes noms et le même ordre d’arguments.

phone.numberCopy Anchor Link

Côté : serveur · Attend : non

phone.number(source: number): string | null

local number = aiLib.phone.number(source)

Retour le numéro de téléphone du joueur, ou null (Lua nil) quand il n’en a pas ou qu’aucun script de téléphone ne tourne.

const number = phone.number(source);
if (!number) return fail("NO_PHONE_NUMBER");

phone.sourceOfCopy Anchor Link

Le joueur en ligne à qui appartient un numéro de téléphone.

Côté : serveur · Attend : non

phone.sourceOf(number: string): number | null

local source = aiLib.phone.sourceOf(number)

Retour l’id serveur, ou null (Lua nil) quand personne en ligne n’a ce numéro.

const owner = phone.sourceOf("555-0101");
if (owner !== null) notify(owner, "Your phone is ringing");

phone.hasPhoneCopy Anchor Link

Indique si le joueur porte un téléphone.

Côté : serveur · Attend : non

phone.hasPhone(source: number): boolean

local has = aiLib.phone.hasPhone(source)

Retour true quand il en a un ; false sinon, ou sans script de téléphone.

if (!phone.hasPhone(source)) return fail("NEED_PHONE");

phone.mailCopy Anchor Link

Envoie un mail sur le téléphone d’un joueur.

Côté : serveur · Attend : non

phone.mail(to: number | string, mail: PhoneMail): boolean

local ok = aiLib.phone.mail(to, mail)

Le type est PhoneMail.

Retour true quand il est envoyé, false sinon.

phone.mail(source, {
  sender: "Downtown Cab Co.",
  subject: "Your shift",
  message: "Pick up the taxi at the depot.",
});

phone.messageCopy Anchor Link

Envoie un SMS.

Côté : serveur · Attend : non

phone.message(from: string, to: number | string, text: string): boolean

local ok = aiLib.phone.message(from, to, text)

Retour true quand il est envoyé, false sinon.

phone.message("Dealer", source, "Meet me behind the gas station.");

phone.notifyCopy Anchor Link

Affiche une notification dans le téléphone.

Côté : serveur · Attend : non

phone.notify(source: number, notification: PhoneNotification): boolean

local ok = aiLib.phone.notify(source, notification)

Le type est PhoneNotification.

Retour true quand elle est affichée, false sinon.

phone.notify(source, { title: "Bank", message: "Salary paid: $250", app: "bank" });

appearanceCopy Anchor Link

L’apparence enregistrée des personnages via la couche apparence d’ai-core, quel que soit le script de vêtements qui tourne (ai-appearance, tgiann-clothing).

appearance.getCopy Anchor Link

L’apparence enregistrée d’un personnage, chargé ou non. Utilisez-la pour habiller un ped qui représente un personnage (un corps endormi, un mannequin) : transmettez le résultat tel quel à appearance.apply côté client (Lib : client).

Côté : serveur · Attend : oui (Promise en TypeScript, cède la main (yield) dans le thread en Lua)

appearance.get(charId: number): Promise<CharacterAppearance | null>

local look = aiLib.appearance.get(charId) -- { model, data } ou nil, à appeler dans un thread

RetourCopy Anchor Link

Promise<CharacterAppearance | null> : CharacterAppearance est { model, data } (le hash du modèle du ped et les données d’apparence propres au script de vêtements). null quand le personnage n’en a pas, qu’aucun script de vêtements ne tourne, ou qu’ai-core est arrêté.

ExempleCopy Anchor Link

import { appearance, online, playersNear } from "@aicore-fivem/lib/server";

async function sendLook(source: number) {
  const charId = online.charId(source);
  if (charId === undefined) return;
  const look = await appearance.get(charId);
  if (!look) return;
  // Seuls les joueurs proches de ce personnage ont besoin de l’apparence.
  for (const other of playersNear(source, 100)) emitNet("my-sleepers:look", other, source, look);
}

appearance.providerCopy Anchor Link

Côté : serveur · Attend : non

appearance.provider(): string | null

local name = aiLib.appearance.provider()

Retour le script de vêtements qui répond, ou null (Lua nil) quand aucun ne tourne.

console.log(`looks through ${appearance.provider() ?? "nothing"}`);