AI Core
Dokumentacja APIAI Core: eksporty serwerowe

Telefon

Numery telefonów, maile, wiadomości tekstowe i powiadomienia telefonu przez skrypt telefonu, którego używa serwer.

Wywołania telefonu przechodzą przez ai-core, nigdy przez własne eksporty skryptu telefonu. ai-core przekazuje każde wywołanie do pierwszego działającego skryptu telefonu (tgiann-phone, lb-phone, gksphone i inne z listy zgodności). Dopóki nie działa żaden telefon, każde wywołanie odpowiada null lub false.

GetPhoneNumber

Numer telefonu gracza.

Strona: Serwer · Czeka: nie · Lib: phone.number

Sygnatura
GetPhoneNumber(source: number): string | null
Lua
local number = exports['ai-core']:GetPhoneNumber(source) -- string lub nil

Parametry

Prop

Type

Zwraca

string | null: numer tak, jak zapisuje go skrypt telefonu. null, gdy gracz go nie ma, nie działa żaden telefon albo source nie jest liczbą.

Przykład

import { onClientCallback, resourceExport } from "@aicore-fivem/lib/server";
import { fail } from "@aicore-fivem/lib/shared";

const core = resourceExport("ai-core");

// Przedmiot wizytówki pokazuje numer właściciela.
onClientCallback("myscript:myNumber", (source) => {
  const number = core.GetPhoneNumber(source);
  return number ? { ok: true, number } : fail("NO_PHONE_NUMBER");
});

GetSourceByPhone

Gracz online, który ma dany numer telefonu.

Strona: Serwer · Czeka: nie · Lib: phone.sourceOf

Sygnatura
GetSourceByPhone(number: string): number | null
Lua
local src = exports['ai-core']:GetSourceByPhone('5551234') -- number lub nil

Parametry

Prop

Type

Zwraca

number | null: id serwera. null, gdy właściciel tego numeru nie jest online, numer jest nieznany, nie działa żaden telefon albo number nie jest tekstem.

Przykład

import { notify, resourceExport } from "@aicore-fivem/lib/server";
import { Locale } from "common";

const core = resourceExport("ai-core");

/** A taxi job tells the caller their cab is on the way, if they are online. */
export function cabOnTheWay(callerNumber: string): void {
  const caller = core.GetSourceByPhone(callerNumber);
  if (caller !== null) notify(caller, Locale("NOTIFY_CAB_COMING"), "info");
}

HasPhone

Czy gracz ma telefon (dla skryptów telefonu, które wymagają przedmiotu telefonu: czy go nosi).

Strona: Serwer · Czeka: nie · Lib: phone.hasPhone

Sygnatura
HasPhone(source: number): boolean
Lua
local has = exports['ai-core']:HasPhone(source)

Parametry

Prop

Type

Zwraca

boolean: true, gdy skrypt telefonu mówi, że gracz ma telefon. false, gdy nie ma, gdy nie działa żaden telefon albo source nie jest liczbą.

Przykład

import { onClientCallback, resourceExport } from "@aicore-fivem/lib/server";
import { fail } from "@aicore-fivem/lib/shared";

const core = resourceExport("ai-core");

// Praca, która rozdaje zadania wiadomościami tekstowymi, wymaga telefonu.
onClientCallback("myscript:startDeliveries", (source) =>
  core.HasPhone(source) ? { ok: true } : fail("NEED_PHONE"),
);

SendPhoneMail

Wysyła mail na telefon gracza.

Strona: Serwer · Czeka: nie · Lib: phone.mail

Sygnatura
SendPhoneMail(to: number | string, mail: PhoneMail): boolean
Lua
local sent = exports['ai-core']:SendPhoneMail(source, { sender = 'LS Customs', subject = 'Invoice', message = '...' })

Parametry

Prop

Type

PhoneMail

Prop

Type

Teksty są pokazywane tak, jak zostały podane: przekazuj przetłumaczone teksty. Zobacz PhoneMail.

Zwraca

boolean: true, gdy skrypt telefonu przyjął mail. false, gdy gracz nie ma numeru, brakuje subject lub message, nie działa żaden telefon albo odmówił.

Przykład

import { resourceExport } from "@aicore-fivem/lib/server";
import { Locale } from "common";

const core = resourceExport("ai-core");

/** The heist contact mails the location after the job was accepted. */
export function mailHeistLocation(source: number, street: string): void {
  core.SendPhoneMail(source, {
    sender: Locale("MAIL_CONTACT"),
    subject: Locale("MAIL_HEIST_SUBJECT"),
    message: Locale("MAIL_HEIST_BODY", street),
  });
}

SendPhoneMessage

Wysyła wiadomość tekstową z jednego numeru do gracza lub numeru.

Strona: Serwer · Czeka: nie · Lib: phone.message

Sygnatura
SendPhoneMessage(from: string, to: number | string, text: string): boolean
Lua
local sent = exports['ai-core']:SendPhoneMessage('Dispatch', source, 'Your cab is here.')

Parametry

Prop

Type

Zwraca

boolean: true, gdy skrypt telefonu przyjął wiadomość. false, gdy odbiorca nie ma numeru, from lub text nie jest tekstem, nie działa żaden telefon albo odmówił.

Przykład

import { resourceExport } from "@aicore-fivem/lib/server";
import { Locale } from "common";

const core = resourceExport("ai-core");

/** The next delivery address arrives by text. */
export function textNextStop(source: number, street: string): void {
  if (!core.SendPhoneMessage(Locale("SENDER_DISPATCH"), source, Locale("TEXT_NEXT_STOP", street)))
    console.log(`player ${source} could not get the text`);
}

PhoneNotify

Pokazuje powiadomienie na telefonie gracza.

Strona: Serwer · Czeka: nie · Lib: phone.notify

Sygnatura
PhoneNotify(source: number, notification: PhoneNotification): boolean
Lua
local shown = exports['ai-core']:PhoneNotify(source, { title = 'Bank', message = 'Salary paid', app = 'bank' })

Parametry

Prop

Type

PhoneNotification

Prop

Type

Zobacz PhoneNotification.

Zwraca

boolean: true, gdy skrypt telefonu je pokazał. false, gdy brakuje title, nie działa żaden telefon, source nie jest liczbą albo odmówił.

Przykład

import { resourceExport } from "@aicore-fivem/lib/server";
import { Locale } from "common";

const core = resourceExport("ai-core");

/** Tells the owner their car was towed. */
export function towedNotice(source: number, plate: string): void {
  core.PhoneNotify(source, { title: Locale("PHONE_TOW_TITLE"), message: Locale("PHONE_TOW_TEXT", plate) });
}

Na tej stronie