Ö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_phonographeş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ı
VolumeSaveDelayms 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) vemusic.youtube.combağlantılarının hepsi çalışır. - Bir YouTube çalma listesi bağlantısı yapıştırır (
playlist?list=...ya dawatch?v=...&list=...): liste içe aktarma açılır. Bunun için server'daYouTubeApiKeygerekir; 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 |