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
GetPlayerFromNumberkullan: 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 = trueolduğunda bu, Wisp'in kurulduğu numaradır ve telefonun kendi numarasından farklı olabilir.falseolduğ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
falsedö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.