Server-Side Framework Entegrasyonu

Janto Phone, sunucu tarafında (Server) güçlü bir Bridge (Köprü) mimarisi kullanır. Bu mimari, telefonun framework bağımlılığını minimize ederek ESX, QBCore, QBox ve vRP gibi sistemlerle tam uyumlu çalışmasını sağlar.

Framework Otomatik Algılama

Sistem, sunucunuzda hangi framework'ün kurulu olduğunu otomatik olarak algılar. Konfigürasyonunuzu janto-phone/config/config.lua dosyasından kontrol edebilirsiniz:

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

• auto: Kurulu olan framework'ü (qbx_core, qb-core, es_extended vb.) kaynak isimlerine göre otomatik bulur.
• standalone: Karakter verilerini FiveM lisans numarası üzerinden tutan temel moddur.

Dış Script Entegrasyonu (Exports API)

Diğer scriptlerinizden Janto Phone özelliklerini tetiklemek için geniş bir Exports kütüphanesi sunulmaktadır.

Oyuncu Bilgileri

Fonksiyon	Parametre	Açıklama
GetEquippedPhoneNumber	source	Oyuncunun o an takılı olan telefon numarasını döndürür.
GetSourceFromNumber	number	Belirtilen numaraya sahip aktif oyuncunun source ID'sini döndürür.
HasPhoneItem	source	Oyuncunun envanterinde aktif bir telefon olup olmadığını kontrol eder.

local phoneNumber = exports['janto-phone']:GetEquippedPhoneNumber(source)

Bildirim Gönderme

Herhangi bir scriptten oyuncunun telefonuna (o an elinde olmasa bile) bildirim gönderebilirsiniz.

-- Tek bir oyuncuya bildirim
exports['janto-phone']:SendNotification(source, {
    app = 'System',             -- Uygulama adı (opsiyonel)
    title = 'Hükümet',          -- Başlık
    content = 'Cezanız kesildi', -- Mesaj içeriği
    thumbnail = 'https://...',  -- İkon URL (opsiyonel)
})

-- Herkese duyuru bildirimi
exports['janto-phone']:NotifyEveryone('all', {
    app = 'News',
    title = 'Duyuru',
    content = 'Sunucu yakında bakıma girecektir.'
})

Finansal İşlemler (Banka & Fatura)

Janto Phone Banka uygulaması ile entegre çalışmak için:

-- Banka işlem bildirimi (Maaş, prim vb.)
-- amount pozitifse 'para geldi', negatifse 'ödeme yapıldı' olarak görünür.
exports['janto-phone']:AddTransaction(phoneNumber, 1500, 'Prim Ödemesi')

-- Fatura oluşturma (Polis, Hastane vb.)
-- targetCitizenId: Framework'e göre citizenid veya global identifier
exports['janto-phone']:CreateInvoice(targetCitizenId, 5000, 'LSPD', 'Hız Cezası', 'Memur Cooper')

Sosyal Medya ve İletişim

Fonksiyon	Parametre	Açıklama
SendMessage	from, to, msg	Belirtilen numaralar arasında SMS gönderir.
CreateCall	src, targetNum	Belirtilen oyuncudan karşı numaraya arama başlatır.
GetInstagramUsername	number	Bir telefon numarasına bağlı Instagram adını döndürür.

Veritabanı ve Karakter Tanımlama

Sistem, oyuncuları framework'ünüzün sağladığı benzersiz karakter ID'leri (citizenid, identifier vb.) üzerinden tanır.

• unique_id: Her oyuncunun framework bazlı kimliği.
• phone_number: Bu kimliğe atanmış benzersiz numara.

Eğer özel bir sistem kullanıyorsanız ve oyuncu verileri yüklenmiyorsa, framework'ünüzün oyuncu objesi içinde PlayerData.citizenid veya identifier alanının dolu olduğundan emin olun.