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