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