Özellikler

Fonograf

Müzik uygulaması: fonograf kurmak, yakındaki oyunculara bağlantı ve YouTube kayıtları çalmak, plağı çevirerek sarmak, çalma listeleri, paylaşım, ton, YouTube ve Spotify bağlantıları, içe aktarma ve Config.Music.

Fonograf (music), oyuncunun dünyaya kurduğu fonograflarda müzik çalar. Bir fonografın yakınındaki oyuncular onu duyar. Ayarlar apps/music/config.lua (Config.Music) ve apps/music/config_server.lua içindedir.

#Oyuncu ne yapabilir

  • Fonograf kurar: pocketbook_phonograph eşyasını kullanır (ya da uygulamadaki kur düğmesine basar), yerini seçer ve onaylar. Eşya dünyaya geçer; fonografı toplamak eşyayı geri verir.
  • Fonograflarından birini seçip yönetir: çal, duraklat, durdur, sonraki, önceki, sarma, ses, tekrar, karışık ve sıra.
  • Ses kaydırıcı sürüklenirken hemen duyulur; sahip de yakındaki oyuncular da duyar. Yeni seviye, kaydırıcı VolumeSaveDelay ms durduğunda kaydedilir.
  • Plağı elle çevirerek sarar: pikaptaki plağı saat yönünde sürüklemek ileri, ters yöne sürüklemek geri götürür. Süre ve kaydırıcı onu izler, sahip o noktayı duyar. Bırakınca server'a tek bir atlama gider; dinleyiciler kayıt yeniden yüklenmeden oraya atlar. Süresi bilinen kayıtlarda çalışır.
  • Bir bağlantıdan hemen kayıt koyar, kayıtları adla arar ya da server'ın kendi seçkisinden (Catalog) çalar. www.youtube.com, m.youtube.com (telefon) ve music.youtube.com bağlantılarının hepsi çalışır.
  • Bir YouTube çalma listesi bağlantısı yapıştırır (playlist?list=... ya da watch?v=...&list=...): liste içe aktarma açılır. Bunun için server'da YouTubeApiKey gerekir; anahtar yoksa yalnızca bağlantıdaki video çalar, bağlantı bir video içeriyorsa.
  • Bir koleksiyon tutar: çalma listeleri, favoriler, geçmiş ve sayaçlar.
  • Bir çalma listesini yakındaki bir oyuncuyla paylaşır. Diğer oyuncu dondurulmuş bir kopya görür, kabul eder ya da reddeder.
  • Tonu (bas, orta, tiz, hazır ayarlar), kayıtlar arası yumuşak geçişi ve önerilerden otomatik çalmayı ayarlar.
  • Liste içe ve dışa aktarır.
  • Spotify kuruluysa kayıt bilgisi arar ve resmi Spotify bağlantılarını açar. Yapıştırılan bir Spotify şarkı, albüm ya da çalma listesi bağlantısı YouTube kayıtlarıyla eşlenir: her kayıt "sanatçı - ad" olarak aranır, Spotify'daki süreye %10 yakın bir sonuç tercih edilir, şarkı pikaba konur, liste sırayı değiştirir. Oyuncu kaç kayıt bulunduğunu yazan bir not alır. Spotify'ın sesi oyunda asla çalınmaz.

Sahip, dünyada kendi kurduğu fonografa bakarak kaydı değiştirebilir, duraklatıp çalabilir, sonrakine geçebilir, sesi ayarlayabilir ve toplayabilir. Çalışan bir target script'i varsa onu, yoksa basılı tutma tuşlarını (E, R, G) kullanır.

#Ne gerekir

Gereksinim Notlar
Eşya Fonograf kurmak için pocketbook_phonograph
Sinyal Yeni kayıt göndermek, çalma listesi kurmak, arama, içe aktarma ve paylaşım sinyal ister

#Ayarlar

Anahtar Varsayılan Ne yapar
Enabled true Uygulamayı açar
Item / Model 'pocketbook_phonograph' / 'p_phonograph01x' Eşya ve dünya modeli
MaxPerCharacter 2 Bir karakterin kurabileceği fonograf
PlaceDistance / ControlDistance / MinSpacing 6.0 / 5.0 / 2.0 Kurmak, yönetmek ve iki fonograf arası için metre
HearingDistance 25.0 Fonografın duyulduğu metre
StreamDistance 60.0 Fonograf modelinin göründüğü metre
MaxAudible 3 Bir oyuncunun aynı anda duyduğu fonograf
DefaultVolume 0.45 Başlangıç ses seviyesi
MaxQueue / MaxPlaylists / MaxTracks 50 / 20 / 100 Sıra uzunluğu, çalma listesi, liste başına kayıt
SearchCooldown / LinkCooldown 3000 / 3000 İki arama ve bir oyuncunun iki bağlantısı arasındaki ms
VolumeSaveDelay 2000 Yeni seviyenin kaydedilip loglanması için ses kaydırıcısının durması gereken ms. Dinleyiciler değişikliği hemen duyar
AllowedHosts {} Doğrudan ses bağlantıları için adresler. Boş: her HTTPS adresi
YouTube true YouTube bağlantıları ve araması
YouTubeSearch Direct = true, uç nokta ve istemci değerleri, Language = 'tr', Country = 'TR', Timeout = 8000 API anahtarı olmadan adla arama. Direct = false anahtarsız aramayı kapatır
Interior.Mode / Interior.Volume 'muffle' / 0.45 Dinleyiciyle fonograf arasında duvar: 'muffle', 'mute' ya da 'off'
Target Enabled = true, System = nil, Distance = 2.0, Prompt = true, HoldTime = 600 Dünyada etkileşim. System = nil config_shops.lua içindeki Config.TargetSystem'i kullanır
Target.Keys Change = 0xCEFD9220 (E), Toggle = 0xE30CD707 (R), Next = 0x760A9C6F (G) Basılı tutma tuşları. false birini gizler
Spotify { Enabled = false, Market = 'TR', Limit = 10 } Spotify bilgi araması ve yapıştırılan Spotify bağlantıları. config_server.lua içindeki anahtarları ister
Spotify.Match Enabled = true, MaxTracks = 25, Wait = 500, Cooldown = 30000, MaxJobs = 2 Spotify bağlantılarını YouTube kayıtlarıyla eşleme, aşağıya bak
AutoAdvance true Bir kayıt bitince server sonrakine geçer
History { Enabled = true, Limit = 100, RetentionDays = 30 } Çalınan kayıtlar
Listening { Enabled = true, RetentionDays = 90 } Dinleme ilerlemesi
Statistics { Enabled = true } Çalma sayaçları
Crossfade { Enabled = true, MaxSeconds = 8 } Yumuşak geçiş, yalnızca doğrudan ses. Her fonograf 0'da (kapalı) başlar
Sharing Enabled = true, Range = 5.0, ExpireHours = 48, MaxIncoming = 20, MaxOutgoing = 10, CooldownSeconds = 15 Çalma listesi paylaşımı
Tone { Enabled = true } -6 ile 6 dB arası bas, orta ve tiz. Yalnızca doğrudan ses; YouTube kullanamaz
Imports Enabled = true, YouTube = true, MaxTracks = 100, MaxScan = 300, CooldownSeconds = 5, ExpireMinutes = 30 Liste içe aktarma
Recommendations Enabled = true, Personalize = true, Limit = 12, Autoplay = true Öneriler. Otomatik çalma, sahibi açana kadar her fonografta kapalı başlar
Catalog {} Server'ın kendi kayıtları ve radyo yayınları

#Spotify bağlantıları

Spotify sesi oyunda stream edilemediği için yapıştırılan bir Spotify bağlantısı YouTube kayıtlarıyla eşlenir. Bunun için Spotify.Enabled = true, config_server.lua içinde Spotify ClientId ve ClientSecret, YouTube = true ve kayıt araması (YouTubeSearch.Direct ya da bir YouTubeApiKey) gerekir.

Spotify.Match anahtarı Varsayılan Ne yapar
Enabled true false Spotify katalog sayfasını tutar ama yapıştırılan bağlantıları reddeder
MaxTracks 25 Bağlantı başına eşlenen kayıt. MaxQueue ile de sınırlıdır
Wait 500 İki arama arası ms
Cooldown 30000 Bir oyuncunun iki Spotify bağlantısı arası ms
MaxJobs 2 Server'da aynı anda eşlenen bağlantı

Spotify, yeni açılmış uygulamalara bazı çalma listesi verilerini (kendi editör ve otomatik listeleri) vermeyebilir. Kullanıcı listeleri, albümler ve şarkılar okunur.

#Catalog

Catalog'u yalnızca kullanma hakkın olan çalınabilir bağlantılarla doldur:

luaCatalog = {
    { title = 'Record name', artist = 'Artist', url = 'https://cdn.myserver.com/record.ogg', duration = 180 },
},

#Yalnızca server ayarları

apps/music/config_server.lua:

Anahtar Varsayılan Ne yapar
Spotify.ClientId / Spotify.ClientSecret '' developer.spotify.com'da açılan bir uygulamanın bilgileri. Spotify.Enabled = true ile, katalog sayfası ve yapıştırılan Spotify bağlantıları için gerekir
YouTubeApiKey '' İsteğe bağlı. Anahtarla resmi YouTube araması kullanılır ve YouTube çalma listesi bağlantıları içe aktarılabilir. Doğrudan bağlantılar anahtar istemez
Logs açık, ana webhook'a düşer Bu uygulamanın Discord logu

#İlgili sayfalar