Özellikler

Music (fx-musicapp)

Dünyada sesli çalan paketle gelen müzik akışı uygulaması; telefona nasıl kurulduğu ve ana ayarları.

#Nedir

fx-musicapp; arama, çalma listeleri ve sırası olan bir müzik akışı uygulamasıdır.

  • Kaynaklar. YouTube'da adla ara, bir bağlantı yapıştır, Spotify ya da YouTube çalma listesi içe aktar, doğrudan bir ses URL'si ekle ya da sunucunun tanımladığı kitaplık ve radyo istasyonlarından çal.
  • Telefon bir hoparlördür. Müzik telefondan, dünyadaki konumuna göre çıkar. Yakındaki oyuncular duyar, mesafeyle azalır ve kapalı bir arabanın ya da duvarın arkasından boğuk gelir.
  • CarPlay. Telefonu içinde bulunduğun arabaya bağla, müzik arabaya geçer. Camlar açıkken daha uzağa gider. Çok uzaklaşırsan bağlantı kopar.
  • Arka planda çalma. Telefon kapalıyken müzik çalmaya devam eder. FX Phone'da kontroller Kilitli Ekran'daki müzik alanında ve Dynamic Island'da da görünür.
  • Oyuncu başına. Çalma listeleri, favoriler, geçmiş, ses düzeyi, tema, dil ve crossfade oyuncu başına kaydedilir.
  • Çalma listesi paylaşımı: yakındaki bir oyuncuyla; o onaylar ve bir kopya alır.

#Gereksinimler

Resource Zorunlu
fx-phone Evet (uygulama lb-phone ya da cylex_phone'a da kurulur)
oxmysql Evet
fx-sound veya xsound Evet, birini seç
MySQL 8.0+ veya MariaDB 10.4+ 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.

#Kurulum

cfgensure oxmysql
ensure fx-phone
ensure fx-sound
ensure fx-musicapp

fx-musicapp en sonda olmalıdır. Ardından setup/sql/install.sql dosyasını veritabanında çalıştır. İki kez çalıştırmak güvenlidir.

Ses altyapısını config.lua içinde ayarla:

Config.Audio.Backend Gerektirdiği Ne elde edersin
'fxsound' fx-sound 3D ses, araba kaportası ve duvarlardan low-pass boğukluk, bass boost
'xsound' xsound Yalnızca ses düzeyi ve mesafe, filtre yok

Seçilen altyapı yoksa uygulama yine açılır ve gezinilebilir ama hiçbir şey çalmaz; server konsolu neyi kurman gerektiğini söyler. Bkz. Sound (fx-sound).

#Telefona nasıl kaydolur

Telefon manifest'te bir bağımlılık değildir. Config.Phone.Resource = 'auto' olduğunda uygulama başlangıçta çalışan bir telefon arar ve kendini kurar; konsol seçtiği telefonun adını yazar.

FX Phone adaptörü (client/phone/fxphone.lua), Config.Phone.AppIdentifier (varsayılan fx_music), AppName, Developer, Icon, DefaultApp ve Size ile exports['fx-phone']:AddCustomApp çağırır. Bildirimler küçük resim olarak parça kapağıyla SendNotification kullanır; sayfaya giden mesajlar SendCustomAppMessage üzerinden gider.

Uygulamanın hiç başlamamasını istiyorsan Config.BundledApps içinde ['fx-musicapp'] = 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.Audio.Backend fxsound veya xsound
Config.Audio.DefaultVolume, DefaultQuality Uygulamanın başlangıç ses düzeyi ve bass boost gücü
Config.Audio.Crossfade Hiç ayar kaydetmemiş oyuncular için varsayılan; crossfade süresi aynı blokta ayarlanır ve 0 crossfade'i tüm sunucuda kapatır
Config.Phone Telefon seçimi, AppIdentifier, AppName, Icon, DefaultApp
Config.Theme Varsayılan tema
Config.Notifications Hangi olayların telefon bildirimi gönderdiği
Config.MaxHistory, Config.HomeShelfSize Oyuncu başına tutulan son çalınan kayıtları ve ana sayfa rafı başına parça sayısı
Config.Search, Config.Playlists, Config.Share, Config.Stats Arama, çalma listeleri, paylaşım ve çalma sayıları için sınırlar
Config.Providers Hangi kaynakların açık olduğu
Config.YouTube.SearchMode direct (varsayılan, kurulum gerektirmez) veya apikey (günlük kotası olan ve otomatik çalma karışımı olmayan resmî API)
Config.Spotify Spotify çalma listesi içe aktarma
Config.Autoplay Sıra bittikten sonra devam eden karışım
Config.RadioStations Sunucunun tanımladığı radyo yayınları
Config.RateLimits, Config.Http, Config.Cache İstek sınırları, dışa giden istek ayarları ve önbellek süreleri

config_server.lua yalnızca server tarafındadır. Discord webhook'unu ve YouTube ile Spotify API kimlik bilgilerini tutar. Yaklaşık 100 parçadan uzun Spotify çalma listeleri Spotify API kimlik bilgileri gerektirir; bunlar olmadan çalma listesinin yalnızca ilk kısmı içe aktarılır.

#Performans ve güvenlik

Resource'un README dosyasından:

  • Wait(0) döngüsü yok. Hoparlör tick'i hızını mesafe ve hıza göre ayarlar, bu yüzden boşta bir dünya saniyede bir döngü turuna mal olur.
  • Arama, ayarlar, metadata, trendler ve çözümlenen yayın URL'leri server tarafında önbelleğe alınır.
  • Çalma sayıları bellekte toplanır ve belirli aralıklarla yazılır.
  • Her client isteği önce istek sınırına tabi tutulur, sonra doğrulanır. Çalma listesi sahipliği her değişiklikte server tarafında kontrol edilir.
  • Oyuncunun verdiği URL'ler, herhangi bir istek yapılmadan önce bir izin listesinden geçer (yalnızca https, özel IP aralıkları engelli).

#Export'lar

Export Taraf Amaç
GetVersionStatus() Server Güncelleme kontrolünün sonucu: { state, current, latest, behind }

Uygulamanın başka export'u yoktur.