Özellikler
Maps (fx-mapsapp)
Kayıtlı iğneler, navigasyon ve canlı konum paylaşımı içeren paketle gelen harita uygulaması; telefona nasıl kurulduğu ve ana ayarları.
#Nedir
fx-mapsapp bir harita uygulamasıdır. Telefonda varsayılan olarak "Maps" adıyla görünür; adı Config.Phone.AppName'dir.
- İki görünümlü harita. Çizim bir atlas ya da uydu görüntüsü; iki parmakla yakınlaştırma, sürükleme, çift dokunma ve döndürme ile. Oyuncunun kendi konumu canlıdır; yön konisi ve sokak adıyla birlikte gösterilir.
- Fast Nav. Bir kategoriye (yakıt, hastane, banka vb.) tek dokunuş, en yakınını GPS rotasıyla işaretler. Katalogdaki her konum adına, kategorisine göre ya da koordinat yapıştırılarak aranabilir.
- İğneler. İğne bırakmak için haritaya çift tıkla, ona bir ad ver, kategori seç ve not bırak. Bir iğne Ev, bir iğne de İş olabilir.
- İğne paylaşma. Bir iğneyi kısa bir kodla yayımla ya da yakındaki bir oyuncuya veya bir arkadaşına gönder. Gönderilen iğne kabul edilene kadar karşı tarafın gelen kutusunda bekler ve onun kendi kopyası olur. Kodların süresi dolabilir ya da kullanım sayısı sınırlanabilir.
- Arkadaşların canlı konumları. Yanında duran bir arkadaşını ya da arkadaş koduyla birini ekle, sonra konumunu belirli bir süre boyunca ya da kapatana kadar paylaş. Paylaşım arkadaş başına ve yön başınadır.
- Navigasyon. Rota haritada bir çizgi çizer, oyun içi hedef noktasını ayarlar ve canlı mesafe ile tahmini varış süresini gösterir. Varış, telefon bildirimi olarak gönderilir.
- Oyuncu başına. İğneler, arkadaşlar, paylaşım, tema, dil, birimler ve görünüm seçenekleri oyuncu başına kaydedilir.
Bu, telefonun Harita entegrasyonu sayfasında anlatılan kendi harita özelliklerinden ayrı bir uygulamadır.
#Gereksinimler
| Resource | Zorunlu |
|---|---|
fx-phone |
Evet (uygulama lb-phone ya da cylex_phone'a da kurulur) |
oxmysql |
Evet |
| MySQL 5.7+ veya MariaDB 10.2+ | Evet |
ESX, QBCore, Qbox ile ya da standalone çalışır; otomatik algılanır. Başka bir şey için bridge/custom.lua dosyasını doldur. API anahtarı gerekmez.
#Kurulum
cfgensure oxmysql
ensure fx-phone
ensure fx-mapsapp
setup/sql/install.sql dosyasını veritabanında bir kez çalıştır. maps_ önekli sekiz tablo oluşturur ve iki kez çalıştırmak güvenlidir. Eski bir kurulumu yükseltirken setup/sql/migrations/003_pin_details_and_sharing.sql dosyasını da çalıştır.
fx-mapsapp telefondan sonra başlamalıdır. Önce başlarsa bir telefonun görünmesi için 30 saniye bekler, sonra neyi aradığını yazdırır.
#Telefona nasıl kaydolur
Config.Phone.Resource = 'auto' olduğunda uygulama, hangi desteklenen telefon çalışıyorsa ona kurulur. FX Phone adaptörü (client/phone/fxphone.lua), Config.Phone.AppIdentifier (varsayılan fx_maps), AppName, Developer, Icon, DefaultApp ve Size ile exports['fx-phone']:AddCustomApp çağırır. Server tarafında oyuncunun numarasını exports['fx-phone']:GetPhoneNumber ile okur.
Uygulamanın hiç başlamamasını istiyorsan Config.BundledApps içinde ['fx-mapsapp'] = false ayarla. Bkz. Uygulamalar.
#Öne çıkan config ayarları
config.lua:
| Ayar | Anlamı |
|---|---|
Config.Framework |
auto ya da sabit bir framework |
Config.Locale, Config.Locales |
Varsayılan dil ve oyuncuların seçebileceği diller |
Config.Theme |
Varsayılan tema ve sunulan temalar |
Config.Phone |
Telefon seçimi, AppIdentifier, AppName, Icon, DefaultApp |
Config.Map |
Harita kalibrasyonu |
Config.Position |
Kendi konum döngüsü: dururken ve hareket ederken ne sıklıkla uyandığı |
Config.Route |
Rota çizimi ve varış |
Config.Places |
İğne sınırları |
Config.PinShare |
Paylaşım kodları: uzunluk, geçerlilik süresi, kullanım sınırları |
Config.Friends |
Arkadaş sınırları, arkadaş kodları ve paylaşım süreleri |
Config.Pois |
Konum kataloğu: kategoriler ve yer listesi. Dilediğin gibi ekle, kaldır ya da değiştir |
Config.Avatars |
Arkadaş avatarları |
Config.Notifications, Config.Sound |
Telefon bildirimleri ve arayüz sesleri |
Config.RateLimits, Config.Cache |
İstek sınırları ve önbellek süreleri |
config_server.lua yalnızca server tarafındadır ve Discord webhook ayarlarını tutar.
#Performans ve güvenlik
Resource'un README dosyasından:
- Düzenli sorgu yapan tek şey haritadır, o da yalnızca ekrandayken. Uygulamayı kapatmak, telefonu kaldırmak ya da Ayarlar'a geçmek konum döngüsünü durdurur.
- Konum döngüsü hızını kendisi ayarlar: dururken daha yavaş, hareket ederken daha hızlı. Konum yalnızca oyuncu hareket ettiğinde yayımlanır.
- Arkadaş konumları tek bir server tick'inden, yalnızca haritası açık oyunculara ve yalnızca hareket eden arkadaşlar için gönderilir.
- Arama hiçbir zaman server'a gitmez; katalog config'tedir ve zaten client'tadır.
- Canlı konumlar server tarafında oyuncunun ped'inden okunur. Client nerede olduğunu kendisi bildirmez.
- Paylaşım her tick'te veritabanına karşı kontrol edilir, bu yüzden bir paylaşımı geri almak bir sonraki tick'te etkili olur.
- Her client isteği önce istek sınırına tabi tutulur, sonra doğrulanır.
#Export'lar
| Export | Taraf | Amaç |
|---|---|---|
GetVersionStatus() |
Server | Güncelleme kontrolünün sonucu: { state, current, latest, behind } |
Uygulamanın başka export'u yoktur.