Pulse Phone dokümantasyonu
Pulse Phone geliştirici API'si
Pulse Phone, diğer resource'lara bir sunucu ve istemci API'si sunar: oyuncunun numarasını okuyun, kısa mesaj, posta ve bildirim gönderin, arama başlatın, telefonda olanlara tepki verin ve kendi uygulamalarınızı ekleyin. Bu sayfadaki her şey Pulse Phone 1.5.0'ın phone resource'undan alınmıştır. Her argümanıyla eksiksiz liste Export'lar ve olaylar sayfasındadır.
API nerede
Resource'un adı phone'dur, yani her çağrı exports.phone:... biçimindedir. Kullanmadan önce telefonu bekleyin: IsReady(), veritabanı yanıt verip telefon istek almaya başlayınca true olur.
CreateThread(function()
while GetResourceState('phone') ~= 'started' or not exports.phone:IsReady() do Wait(500) end
print('Pulse Phone is ready')
end)Sunucu konsolundaki phone_api, uygulama API'sinin kısa bir özetini yazdırır.
En çok kullanılan sunucu export'ları
| Export | Ne yapar |
|---|---|
GetPhoneNumber(src) |
oyuncunun elindeki telefonun numarası; yüklenene kadar nil |
SourceOfNumber(number) |
bu numaraya sahip çevrimiçi oyuncu veya nil |
Notify(src, { title, body, app?, actions? }) |
o oyuncunun telefonunda en fazla 3 düğmeli bir bildirim |
SendMessage(src, number, text) |
o oyuncudan bir numaraya kısa mesaj |
SendMail(address, sender, subject, body) |
bir adrese posta |
Call(src, number, video?) |
o oyuncu için arama başlatır |
SetPhoneDisabled(src, bool) |
bir oyuncunun telefonunu kapatır veya açar (hapis, ara sahne) |
RecordTransaction(number, 'sent' or 'received', amount, party, note?) |
Cüzdan'da bir ekstre satırı; para taşımaz |
Başka bir telefon için yazılmış scriptler, o telefonun export'ları yerine bunları çağırır:
| Export | Ne yapar |
|---|---|
ResolvePhone(target[, cb]) |
telefonu { source }, { number }, { email }, { identifier } veya { imei } ile bulur |
DeliverMailTo(target, mail[, cb]) |
o telefona posta: { sender, subject, body } |
SendText(from, to, body[, opts][, cb]) |
bir telefondan veya adı verilen bir servisten kısa mesaj |
DispatchAlert(jobs, { title, body, coords? }) |
bu mesleklerin görevdeki her üyesine uyarı; kaç kişiye ulaştığını döndürür |
Örnek: bir soygun scripti polisi harita işaretiyle uyarır.
local reached = exports.phone:DispatchAlert({ 'police', 'sheriff' }, {
title = 'Store robbery',
body = 'Alarm at the 24/7 on Innocence Blvd.',
coords = vector3(25.7, -1345.6, 29.5),
})Sunucu olayları
Bir sunucu scriptinde AddEventHandler ile dinleyin. Olayları yalnızca telefon tetikler; bir istemci bunları taklit edemez.
| Olay | Argümanlar |
|---|---|
phone:numberChanged |
src, number, oldNumber |
phone:callStarted |
callId, fromNumber, toNumber, fromSrc, toSrc, video |
phone:callEnded |
fromNumber, toNumber, reason, durationMs, fromSrc, toSrc, callId |
phone:messageSent |
fromNumber, toNumber, body |
phone:emergencyCall |
src, service, reason, coords |
phone:wallet:transfer |
fromNumber, toNumber, amount, note |
phone:notification:action |
src, app, notificationId, actionId: Notify çağrınızın sunduğu bir düğmeye basıldı |
İstemci export'ları
| Export | Ne yapar |
|---|---|
Open(), Close(), IsOpen() |
telefonu açar veya kapatır; Open aşağıdaki tüm engellemelere uyar |
AddOpenCheck(fn) |
false döndüren fn() telefonun açılmasını durdurur; resource'unuz durduğunda kaldırılır |
SetRestriction(key, mode) |
oyuncuya ait kendi durumunuz: 'block', 'emergency-only' veya temizlemek için nil |
SetCarAudio(state) |
araç ekranı Pulse Drive'da araç teybinizi gösterir |
GetPhoneNumber(), IsInCall(), GetBattery() |
bu oyuncunun kendi telefonu |
Örnek: bir oyuncu hapishanenizdeyken telefon kullanılamaz.
exports.phone:SetRestriction('myjail', 'block') -- on entering the cell
exports.phone:SetRestriction('myjail', nil) -- on releaseState bag'ler
Sunucu bunları Player(src).state içine, diğer telefon resource'larının kullandığı adlarla yazar; böylece HUD ve dispatch scriptleri bunları değişiklik yapmadan okur: phoneNumber, phoneOpen, inCall, onCallWith, phoneBattery, phoneDead. İstemciler kendilerininkini LocalPlayer.state.phoneOpen olarak okur.
Yapılandırma örnekleri
Telefonun ayarları phone/config/ içindedir. Diğer scriptlerin bağımlı olduğu üç tanesi:
Config.Item = {
required = false, -- true: the player needs the phone item
name = 'phone',
}
Config.Public = {
numberState = true, -- publish Player(src).state.phoneNumber
}
Config.Open = {
blockWhenNuiFocused = true, -- no phone while another menu holds the cursor
}Kendi uygulamalarınız
exports.phone:RegisterApp({ id, name, colour, icon, page = { kind = 'frame', url = 'ui/index.html' } }) Ana Ekran'a ve Uygulama Merkezi'ne bir uygulama ekler. Sayfa kendi frame'inde çalışır ve sunucunuzla telefon üzerinden konuşur. İzinler, bildirimler, diller ve Uygulama Merkezi kaydı isteğe bağlı alanlardır. Tam kılavuz Özel uygulamalar sayfasındadır.
Entegrasyon notları
- Pulse Phone, lb-phone, qb-phone ve NPWD'nin olay adlarına kendisi yanıt verir; bu yolla posta, mesaj ve uyarı gönderen scriptler çalışmaya devam eder. Başka bir telefonun export'larını çağıran scriptlerde tek bir değişiklik gerekir:
exports.phone. Bkz. Telefon değiştirme. - Gerçek
sourcedeğerini kendi sunucu olaylarınızdan geçirin. Oyuncu kimliğini asla bir istemci mesajından almayın. - Banka, garaj, konut ve dispatch, başlangıçta seçilen telefon köprüleri üzerinden bağlanır. Kendi scriptinizi sağlayıcı olarak ekleyebilirsiniz: Gelişmiş entegrasyonlar.
Sık sorulan sorular
Pulse Phone resource'unun adı nedir?
phone. Her export exports.phone:Name(...) biçimindedir. Klasör adını değiştirmeyin; diğer scriptler ve envanter eşya kancaları ona bu adla ulaşır.
lb-phone veya qb-phone için yazılmış scriptler Pulse Phone ile çalışır mı?
Bu telefonların olaylarını kullanan scriptler (posta, mesaj, bildirim, telefon numarası) düzenleme gerekmeden çalışır. Export'larını çağıran scriptlerde bunun yerine exports.phone gerekir.
Pulse Phone'a kendi uygulamamı ekleyebilir miyim?
Evet. Resource'unuzdan RegisterApp ile kaydedin. Uygulama Merkezi'nde görünür; kılavuz sayfaları, izinleri ve bildirimleri kapsar.