Server exportları

Oyuncular ve numaralar

Bir oyuncunun numarasını, bir numaranın arkasındaki oyuncuyu bulan ve bir telefon kaydını okuyan ya da değiştiren server export'ları.

src bir server id'sidir. identifier, framework'ünün karakter identifier'ıdır (QBCore ve Qbox'ta citizenid, ESX'te identifier) ve çevrimdışı karakterler için de çalışır. Telefon numaraları string'dir.

#GetPhoneNumber

Bir oyuncunun ya da karakterin telefon numarasını döndürür.

Şu adla da kullanılabilir: GetEquippedPhoneNumber

lua---@param target integer|string a server id, or a character identifier
---@return string|nil number
exports['fx-phone']:GetPhoneNumber(target)
lualocal number = exports['fx-phone']:GetPhoneNumber(source)
  • Önce server id olarak denenir; çevrimiçi bir server id olmayan string identifier olarak aranır.
  • Telefonda iki SIM varsa bu birincil hattır.

#GetSourceFromNumber

Bu numaraya sahip çevrimiçi oyuncuyu döndürür.

Şu adla da kullanılabilir: getSourceFromNumber

lua---@param number string
---@return integer|false src false when nobody online has it
exports['fx-phone']:GetSourceFromNumber(number)
lualocal target = exports['fx-phone']:GetSourceFromNumber('5551234')
  • SIM kartlar açıkken, iki SIM'li bir telefonun iki hattından biri de oyuncuyu bulur.

#GetNumberFromIdentifier

Bir karakterin numarasını döndürür.

lua---@param identifier string
---@return string|nil number
exports['fx-phone']:GetNumberFromIdentifier(identifier)
lualocal number = exports['fx-phone']:GetNumberFromIdentifier(citizenid)

#GetIdentifierFromNumber

Bir numaranın ait olduğu karakteri döndürür.

lua---@param number string
---@return string|nil identifier
exports['fx-phone']:GetIdentifierFromNumber(number)
lualocal identifier = exports['fx-phone']:GetIdentifierFromNumber('5551234')
  • SIM kartlar açıkken bu, o numaralı SIM'i telefonunda taşıyan kişidir. Bir SIM'in kayıtlı sahibi için GetPlayerFromNumber kullan: bkz. SIM.

#GetWispNumber

Bir oyuncunun telefonundaki Wisp hesabının numarasını döndürür.

lua---@param src integer
---@return string|nil number nil when the phone has no Wisp account
exports['fx-phone']:GetWispNumber(src)
lualocal number = exports['fx-phone']:GetWispNumber(source)
  • Config.Wisp.Registration = true olduğunda bu, Wisp'in kurulduğu numaradır ve telefonun kendi numarasından farklı olabilir. false olduğunda telefonun birincil numarasıdır. Bkz. Mesajlaşma.

#GetUserData

Bir karakterin telefon kaydını döndürür.

Şu adla da kullanılabilir: getUserData

lua---@class PhoneUser
---@field identifier string
---@field phoneNumber string|nil
---@field iban string
---@field firstname string
---@field lastname string
---@field picture string|nil
---@field online integer|false server id, or false
---@field settings table

---@param identifier string
---@return PhoneUser|nil user
exports['fx-phone']:GetUserData(identifier)
lualocal user = exports['fx-phone']:GetUserData(citizenid)

#GetUserDataBySource

Aynı kaydı server id'ye göre döndürür.

Şu adla da kullanılabilir: getUserDataBySource

lua---@param src integer
---@return PhoneUser|nil user
exports['fx-phone']:GetUserDataBySource(src)
lualocal user = exports['fx-phone']:GetUserDataBySource(source)

#GetUserDataList

Telefonu yüklü olan her oyuncunun kayıtlarını döndürür.

Şu adla da kullanılabilir: getUserDataList

lua---@return PhoneUser[] users
exports['fx-phone']:GetUserDataList()
luafor _, user in ipairs(exports['fx-phone']:GetUserDataList()) do print(user.phoneNumber) end

#SetUserData

Bir karakterin telefon kaydının tek bir alanını değiştirir.

Şu adla da kullanılabilir: setUserData

lua---@param identifier string
---@param key 'phoneNumber'|'iban'|'firstname'|'lastname'|'picture'|'avatar'
---@param value string|false
---@return boolean ok
exports['fx-phone']:SetUserData(identifier, key, value)
luaexports['fx-phone']:SetUserData(citizenid, 'phoneNumber', '5550001')
key Değer
phoneNumber Başka kimsenin kullanmadığı geçerli bir telefon numarası. SIM kartlar açıkken yeni numara birincil hattın SIM'ine verilir; telefonda SIM yoksa başarısız olur
iban 4 ile 34 arasında harf ve rakam, kullanımda olmamalı
firstname, lastname En fazla 50 karakter
picture (ya da avatar) İzin verilen bir görsel bağlantısı ya da kaldırmak için false
  • Bilinmeyen bir anahtar, geçersiz bir değer ya da bilinmeyen bir karakter için false döndürür.

#WipeUser

Telefonun bir karakter için tuttuğu her şeyi siler. Bu işlem geri alınamaz.

Şu adla da kullanılabilir: wipeUser

lua---@param identifier string
---@return boolean ok
exports['fx-phone']:WipeUser(identifier)
luaexports['fx-phone']:WipeUser(citizenid)
  • Çevrimiçi bir oyuncu hemen sıfırdan bir telefon alır.

#FactoryReset

O numaralı telefonu ilk günkü haline döndürür.

lua---@param number string
---@return boolean ok false for an unknown number
exports['fx-phone']:FactoryReset(number)
luaexports['fx-phone']:FactoryReset('5551234')
  • Ayarlar, Ana Ekran, yüklü uygulamalar, PIN ve kurulum sihirbazı sıfırlanır. Kişiler, sohbetler, fotoğraflar ve numara kalır.