sonopto.
☰

Uygulamalar

Media JSON Tümleştirmesi

Dış bir JSON akışından görsel ve video çekerek ekran içeriğini kendiliğinden güncelleme; akış biçimi, alan tanımları ve güncelleme davranışı.

Media JSON nedir?

Media JSON, görsel ve video gibi çoklu ortam içeriklerini taşımak için tasarlanmış hafif bir JSON yapısıdır. MRSS’in çağdaş bir alternatifidir; API tümleştirmesi ve içerik otomasyonu için iyileştirilmiştir.

Neden Media JSON?

Media JSON ile ekranınızı dış bir JSON akışına bağlayarak içerik güncellemelerini otomatikleştirirsiniz. Dosyaları elle yüklemeniz gerekmez; akıştaki her değişiklik ekranlarınıza anında yansır.

Şunlar için elverişlidir:

  • Mağaza kampanyaları
  • Haber ve duyurular
  • Menü panoları
  • Dinamik görsel ve video kampanyaları

Media JSON uygulamasını kullanma

  • Panele giriş yapın.
  • Çalma listesini, ardından akışı ekleyeceğiniz katmanı seçin.
  • Katman boşsa uygulamalar penceresi kendiliğinden açılır. Varsa Add New düğmesine tıklayın.
  • Media JSON uygulamasını General Apps, Video Apps ve News Apps bölümlerinde bulabilirsiniz.
  • Media JSON seçeneğine tıklayın.
  • Akış adresini girin.
  • Kaç öğe gösterileceğini seçin.
  • Medya türünü seçin: görseller, videolar ya da ikisi birden.
  • Değişiklikleri uygulamak için Save düğmesine tıklayın.

Akış gereksinimleri

Media JSON akışınız:

  • geçerli bir HTTPS sunucusunda barındırılmalı,
  • ya da herkese açık bir API ucundan dönmelidir.

Media JSON biçimi örneği

{
 "channel": {
 "items": [
 {
 "title": "Image 1",
 "mediaContent": {
 "url": "https://files.cloud-digitalsignage.com/mrss/files/1.jpg",
 "type": "image/jpeg",
 "medium": "image",
 "duration": "10",
 "changeKey": "a077ae97dfe45af878f0e0fafdc05c85"
 }
 },
 {
 "title": "Video 1",
 "mediaContent": {
 "url": "https://files.cloud-digitalsignage.com/mrss/files/a.mp4",
 "type": "video/mp4",
 "medium": "video",
 "duration": "10",
 "changeKey": "f11b8c8d750d2087e0a6c0478840063d"
 }
 }
 ]
 }
}

Örnek akış dosyası: https://files.cloud-digitalsignage.com/media-json/media-json.json

Media JSON alan kılavuzu

Alanları bilmek, içeriğinizin ekranlarda doğru görünmesini sağlar.

Kök yapı

AlanZorunluAçıklama
channel✅Akıştaki tüm öğeleri taşıyan kapsayıcı
items✅Medya öğelerinin dizisi

Her item

AlanZorunluAçıklama
title✅Medyanın başlığı
mediaContent✅Medya dosyasının bilgilerini taşıyan nesne

mediaContent öznitelikleri

ÖznitelikZorunluAçıklama
url✅Medya dosyasının doğrudan HTTPS adresi
type✅MIME türü; örneğin image/jpeg ya da video/mp4
medium✅image ya da video
duration✅Saniye cinsinden gösterim süresi
changeKey❌ (önerilir)Benzersiz kimlik (örneğin MD5 özeti). Adres aynı kalsa bile içerik değiştiğinde yenilemeyi zorlar.

Örnek öğe

{
 "title": "Video 1",
 "mediaContent": {
 "url": "https://yourdomain.com/media/video1.mp4",
 "type": "video/mp4",
 "medium": "video",
 "duration": "15",
 "changeKey": "abc123xyz456def789"
 }
}

Bu öğe video1.mp4 dosyasını 15 saniye gösterir. İçerik yalnızca url ya da changeKey değiştiğinde yenilenir.

Güncellemeler nasıl çalışır

  • İçerik, adres ya da changeKey değiştiğinde güncellenir.
  • Hiçbir şey değişmezse medya yeniden indirilmez.
  • Adres aynı kalırken dosya değiştiyse changeKey değerini yenileyin.

Güncelleme sıklığı

  • Akışlar 15 dakikada bir denetlenir.
  • Yalnızca etkin çalma listesi olan çevrimiçi oynatıcılar denetim tetikler.
  • Çevrimdışı oynatıcılar yeniden bağlandığında güncellenir; bu 15 dakikaya kadar sürebilir.

Medya depolama

  • Dosyalar JSON akışından bulut depolamaya indirilir.
  • Ardından çevrimdışı oynatma için oynatıcılarınıza eşitlenir.

Desteklenen medya türleri

  • Görseller: image/jpeg, image/png
  • Videolar: video/mp4, video/webm

Her mediaContent nesnesi şunları içermelidir:

  • url
  • type
  • medium
  • duration
  • changeKey (isteğe bağlı ama önerilir)

İpuçları

  • Akışları küçük tutun; daha hızlı yüklenir.
  • Medya dosyaları için CDN ya da hızlı bir sunucu kullanın.
  • Aynı adresle dosya değiştirdiğinizde changeKey değerini mutlaka güncelleyin.