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.

Pulse Phone 1.5.2 için4 dk okumaGüncelleme:

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.

Lua
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.

Lua
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.

Lua
exports.phone:SetRestriction('myjail', 'block')   -- on entering the cell
exports.phone:SetRestriction('myjail', nil)       -- on release

State 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:

Lua
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 source değ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.

İngilizceden çevrilmiştir. Buradaki herhangi bir bilgi İngilizce sayfayla çelişirse İngilizce sayfa geçerlidir. English