Skip to content

Client-Side Entegrasyon Rehberi

Janto Phone, istemci tarafında FiveM'in native özelliklerini kullanarak framework bağımsız bir yapı sunar. ESX, QBCore ve QBox gibi popüler frameworkler için "tak-çalıştır" desteği mevcuttur. Eğer özel bir framework kullanıyorsanız, telefonun karakter durumlarını doğru algılaması için aşağıdaki standartları takip etmeniz yeterlidir.

Framework Seçimi

Sunucunuzdaki framework tipini janto-phone/config/config.lua içerisinden belirleyebilirsiniz.

lua
Config.Framework = 'auto' -- 'esx', 'qbcore', 'qbox', 'vrp' veya 'standalone'

Karakter Durumu ve Ölüm Kontrolü (State Bags)

Janto Phone, oyuncunun o anki durumunu (ölü mü, yaralı mı vb.) izlemek için FiveM'in reaktif State Bags sistemini kullanır. Eğer hazır bir framework kullanmıyorsanız, karakter durumunu şu anahtarlar üzerinden güncellemelisiniz:

AnahtarBeklenen DeğerAçıklama
isDeadbooleanOyuncu öldüğünde true yapılmalıdır. Telefonu otomatik kapatır.
inLastStandbooleanYaralanma/baygınlık modunda true yapılmalıdır.

Örnek Kullanım (Lua):

lua
-- Ölüm gerçekleştiğinde:
LocalPlayer.state:set('isDead', true, true)

-- Yeniden doğduğunda:
LocalPlayer.state:set('isDead', false, true)

Bildirimler ve Kontroller

  • Bildirim Sistemi: Sistem varsayılan olarak ox_lib veya framework'ünüzün dâhili bildirim sistemini kullanır.
  • PTT Desteği: Telefon açıkken veya mesaj yazarken sesli konuşma tuşunuz (Telsiz/PTT) engellenmez, her zaman aktif kalır.
  • Hareket Engelleme: Klavye ile metin girişi yapılan alanlarda karakter hareketleri otomatik olarak askıya alınır.

Performans

İstemci tarafındaki tüm kontroller "event-based" (olay bazlı) çalışır. Telefon kapalıyken veya bekleme durumundayken 0.00ms CPU kullanımı hedeflenmiştir. Teknik detaylar veya ağır döngüler yerine sistem reaktif sinyalleri dinler.

Released under the MIT License.