Televizyon Sistemi
TV etkileşimi, medya bağlantı güvenliği, ses, erişim, kumanda süresi ve oynatma sırası için ayrıntılı rehber.
Televizyon Sistemi#
Açık ayar dosyası#
Dosya: dxa-tv/config.lua
Televizyonlar her modelin kendi ekran yüzeyini kullanacak şekilde çalışır. Ortak, tek bir düz ekran tanımı kullanmak bazı modellerde görüntünün TV arkasına taşmasına neden olur; Renderer.useNativeRenderTargets varsayılan true kalmalıdır.
Etkileşim ve görüntü#
Interaction.targetDistance 3 m, TV ile etkileşim uzaklığıdır. commandDistance 5 m komutla erişim sınırıdır. scanIntervalMs 1000 tarama aralığı, maxActiveDuis 8 aynı anda çalışacak ekran üst sınırıdır. Bu üst sınırı yükseltmek çok sayıda açık TV’de istemci yükünü artırabilir.
Renderer.width/height 1280×720 varsayılan görüntü çözünürlüğüdür. Daha yüksek çözünürlük görüntüyü iyileştirir ama her aktif ekranın maliyetini yükseltir. driftThresholdSeconds zaman eşitleme toleransıdır. planeWorldMultiplier yalnızca profil boyutunu dünya yüzeyine dönüştürmekte kullanılır; görüntü taşması sorununda bunu değiştirmek yerine TV modelinin doğru ekran profilini doğrulayın.
Bağlantı ve yayın kuralları#
Media.requireHttps true iken yalnız HTTPS bağlantılar kabul edilir. Bu güvenli varsayılandır. maxUrlLength 2048, maxTitleLength 120; maxQueueItems ve historyLimit 50’dir. Kuyruğu çok büyütmek arayüzü ve kayıtları gereksiz şişirir.
allowedProviders YouTube, Twitch, doğrudan video, HLS ve görsel türlerini kontrol eder. allowedDomains izinli alan listesidir. Yeni alan eklemek için yalnızca güvenilir, HTTPS içerik sağlayıcısı kullanın. Herhangi bir alanı tamamen serbest bırakmak oyuncuyu kötü niyetli veya sorunlu sayfalara yönlendirebilir.
YouTube bağlantısı doğru olsa bile video sahibi gömülü oynatmaya izin vermemiş olabilir. Bu bir ayar hatası değildir; başka video deneyin. Twitch için yayıncı/parent alanına ilişkin sağlayıcı şartları da geçerli olabilir.
Ses ve erişim#
Audio.roomAttenuation odadaki ses azalmasını belirler; 0.2 normal bir iç mekân etkisidir. defaultMasterVolume 100 varsayılan genel sestir. masterVolumeKvp oyuncunun yerel ses tercihi anahtarıdır; değiştirilirse mevcut oyuncuların önceki ses tercihi sıfırlanabilir.
Admin.qbPermissions admin/god ve ace dxa-tv.admin yönetim işlemlerini sınırlar. DefaultLock.mode public iken herkes erişir. İşe, çeteye veya karaktere özel ekran için DefaultLock içindeki jobs, gangs veya citizenIds listesini düzenleyin. Bu listelerdeki değerler mevcut QBCore verisiyle harf harfine aynı olmalıdır.
Kumanda ve koruma#
Control.maxDistance 50 m ekranı uzaktan yönetme sınırıdır. releaseAfterSeconds 15, kullanılmayan kumandayı serbest bırakır. heartbeatSeconds 5 kumanda bağlantı kontrolüdür. pinGrantSeconds 900, doğru PIN sonrası erişimin 15 dakika sürmesidir.
Security.rateLimitWindowSeconds 5 ve rateLimitMaxActions 12 aynı oyuncunun çok hızlı işlem yapmasını sınırlar. Normal kullanımda bu sınırı yükseltmek gerekmez. PIN 4–8 karakter olmalıdır. pinPepperConvar gizli sunucu tarafı destek değeridir; açık dokümana veya oyuncu mesajlarına yazmayın.
Schedule.timezone Europe/Istanbul, planlı yayınlar için Türkiye saatini kullanır. tickSeconds 30 plan kontrol aralığıdır. Aynı ekran için çakışan yayın saatleri girmeyin.
Sorun çözümü#
| Belirti | Çözüm |
|---|---|
| Görüntü TV’nin arkasına/altına taşıyor | useNativeRenderTargets değerini true bırakın; ilgili modelin doğru ekran yüzeyini kontrol edin. |
| Ses veya görüntü yok | HTTPS bağlantısını, izinli alan listesini, sağlayıcı türünü ve video sahibinin gömme iznini kontrol edin. |
| “Çok uzaksın” bildirimi | Interaction/Control mesafelerini kontrol edin; oyuncunun TV’ye gerçek uzaklığını deneyin. |
| Oyuncu ekranı kullanamıyor | DefaultLock, iş/çete/karakter listesi ve PIN erişim süresini kontrol edin. |
| TV kasıyor | Çözünürlüğü yükseltmeyin; maxActiveDuis değerini azaltın ve gereksiz açık ekranları kapatın. |