martignage
Dokümantasyon

Smart-Signage'ı ustalıkla kullanmak için gereken her şey.

İlk hesabınızı oluşturmaktan 500 ekranlık bir filoyu yönetmeye: kavramlar, rehberler, API, oynatıcılar.

Hızlı başlangıç

Smart-Signage bir SaaS platformudur. Güncel herhangi bir tarayıcıdan erişebilirsiniz. Yönetici tarafında hiçbir kurulum gerekmez. Ekran tarafında ise donanımınıza uygun oynatıcıyı kurarsınız (web, Android APK, yakında Tizen).

  1. 1

    Hesabınızı oluşturun

    my.smart-signage.app adresinden ücretsiz hesabınızı oluşturun. Çalışma alanınız anında hazır olur.

  2. 2

    İlk medyalarınızı yükleyin

    Görsel, video, PDF veya web akışı. Sürükleyip bırakmanız yeterli.

  3. 3

    Bir oynatma listesi hazırlayın

    Medyaları sıralayarak sürükleyin, öğe başına süreyi ayarlayın, geçişler ekleyin.

  4. 4

    Ekranınızı eşleştirin

    Oynatıcıyı açın, 6 haneli PIN kodunu okutun; ekran kiracıya bağlanır.

  5. 5

    Yayınlayın

    Oynatma listesini ekrana atayın; yayın bir dakika içinde başlar.

Temel kavramlar

Platformu altı varlık yapılandırır. Bir kez kavradığınızda her yerde işinize yarar.

Kiracı
Bir müşteri. Medyaları, oynatma listelerini, ekranları ve kullanıcıları tamamen yalıtır. Bir operatör (örn. Smart-Signage) yönetim konsolundan birden fazla kiracıyı yönetir.
Kullanıcı & rol
Owner, Admin, Editor, Operator, Viewer. Roller neyin görüleceğini ve neyin değiştirilebileceğini belirler.
Medya
Görsel, video, PDF, URL veya HTML şablonu. Otomatik algılanan küçük resim ve süreyle birlikte CDN'de saklanır.
Oynatma listesi
Öğe başına süre, geçiş, döndürme ve yakınlaştırma içeren sıralı medya dizisi.
Zamanlama
Bir oynatma listesinin belirli bir saat aralığında veya günde bir ekrana atanması. Birden fazla zamanlama = dayparting.
Cihaz (ekran)
Bağlı bir oynatıcı. Önce PIN, ardından bir belirteçle tanımlanır. Heartbeat + ekran görüntüsü gönderir.

Kiracılar & kullanıcılar

Çok kiracılı yapı

Her kiracının kendi medyaları, oynatma listeleri ve ekranları vardır. Bir kullanıcı bir veya birden fazla kiracıya bağlı olabilir. Operatörler (bayiler, entegratörler) portföylerindeki tüm kiracılara yönetim konsolundan erişir.

Roller

RolMedyaOynatma listeleriEkranlarFaturalama
OwnerTümüTümüTümüTümü
AdminTümüTümüTümüOkuma
EditorOluştur / düzenleOluştur / düzenleOynatma listesi ata
OperatorOkumaOkumaAta / eşleştir
ViewerOkumaOkumaOkuma

Kimlik doğrulama

Varsayılan olarak e-posta / parola, e-posta ile sıfırlama seçeneğiyle. Çoklu oturum açma (SSO) Premium pakette sunulur.

Medya & kitaplık

Desteklenen formatlar

TürFormatlarMaks. boyutNotlar
GörselJPG, PNG, WEBP, SVG20 MBKüçük resim otomatik oluşturulur
VideoMP4 (H.264 / H.265), WEBM500 MBOtomatik çoklu çözünürlük yeniden kodlama
PDFPDF 1.7+50 MBSayfa sayfa veya belgenin tamamı
URLWeb (HTTPS)Korumalı iframe, kısıtlı betikler
ŞablonHTML / CSS / JS5 MBDeğişkenler {{nom}}, {{prix}}, {{date}}…

Düzenleme

Klasörler, etiketler, tam metin arama. Medyalar sürümlenir: dosyayı değiştirmeniz, onu kullanan tüm oynatma listelerine yeni sürümü yayar. Yeniden atama yapmanız gerekmez.

Şablonlar & Studio IA

Studio IA, brief'inizden bir HTML/CSS şablonu üretir. Görsel sonucu düzenlersiniz, kod ise teknik profiller için erişilebilir kalır.

Kullanılabilir değişkenler

<div class="promo">
  <h1>{{ titre }}</h1>
  <p>{{ description }}</p>
  <span class="prix">{{ prix }} €</span>
  <small>Son geçerlilik tarihi {{ date_fin | date:"d MMM" }}</small>
</div>

Değişkenler oynatma listesi veya yayın bazında tanımlanır. Ayrıca API üzerinden de beslenebilirler (Premium paket) — emlak ofisleri, restoranlar ve dinamik fiyatlandırma için kullanışlıdır.

Studio IA sınırları

  • Beyaz listede olmayan harici betikler kullanılamaz (güvenlik).
  • Yazı tipleri Google Fonts üzerinden veya kiracı yüklemesiyle.
  • Free pakette ayda 2 üretim, ücretli paketlerde ayda 20.

Oynatma listeleri

Oynatma listesi, sıralı öğelerden oluşan bir dizidir. Her öğenin bir süresi, bir sığdırma modu (cover / contain / fill), bir döndürmesi, bir yakınlaştırması ve bir geçişi vardır.

Kullanılabilir geçişler

  • CUT — sert kesme (varsayılan, en akıcı olan).
  • FADE — 500 ms çapraz geçiş.
  • SLIDE — 800 ms yatay kaydırma.

En iyi uygulamalar

  • Görsel süresi: ortalama 6 ila 10 sn. Çok kısa = eksik okuma. Çok uzun = bıkkınlık.
  • Video: varsayılan süreyi koruyun (= dosya süresi).
  • %70 kalıcı içerik + %30 promosyon / sezonluk içerik harmanlayın.

Zamanlama & dayparting

Zamanlama, bir oynatma listesini belirli bir saat aralığında bir ekrana atar. Birden fazla zamanlama öncelik sırasına göre bir arada bulunabilir.

Aralık türleri

  • Saatlik — örn. pazartesi-cuma 08.00-11.00: « Croissants » oynatma listesi.
  • Tarihli — örn. 1-6 ocak arası: « Galette des Rois » oynatma listesi (yüksek öncelik).
  • Kalıcı — varsayılan oynatma listesi; özel aralıkların dışında oynatılır.

Öncelik

Aynı anda birden fazla zamanlama etkin olduğunda en yüksek öncelik kazanır. Sezonluk promosyon haftalık programın, haftalık program da kalıcı oynatma listesinin önüne geçer. Tüm ayrıntılar — acil durum uyarısı, kalıcı yayın, uzaktan kumanda, ekran duvarı — bir sonraki bölümde açıklanmıştır.

Yayın öncelikleri: ekranda ne görünür?

Aynı ekranı aynı anda birden fazla kaynak hedefleyebilir: bir zamanlama, elle başlatılan bir yayın, bir ekran duvarı, bir uyarı. Hiçbir şey kalıcı olarak silinmez — öncelikli kaynak durduğu anda bir önceki kendiliğinden geri döner.

Tek cümlelik kural

Acil durum uyarısı her şeyin üzerini kaplar; aksi hâlde en yüksek öncelikli kaynak görünür; bu kaynak bir ekran duvarını yönetiyorsa her ekran kendi payını gösterir.

Ekranın sırayla kontrol ettikleri

  1. 1

    Etkin bir acil durum uyarısı var mı?

    Varsa, tüm filoda ekranın tamamını kaplar ve hiçbir şey onun önüne geçemez. İçerik altta dönmeye devam eder: uyarı kaldırıldığında hiçbir müdahaleye gerek kalmadan yeniden görünür.

  2. 2

    İçeriği hangi kaynak kazanır?

    Her kaynağın 0 ile 99 arasında bir önceliği vardır. En yüksek olan kazanır. Öncelik eşitse en eski kaynak kazanır — bu nedenle bu sıralamaya güvenmek yerine öne çıkması gereken kaynağın önceliğini yükseltmek daha doğrudur.

  3. 3

    Bu içerik bir ekran duvarını mı yönetiyor?

    Öyleyse ekran yalnızca duvardaki kendi karesini gösterir; tüm paneller aynı anda aynı görüntüyü göstersin diye ortak bir saate hizalanır. Aksi hâlde içeriği tam ekran gösterir.

Seviyeler, en güçlüden en zayıfa

  • Acil durum uyarısı — yarışma dışı: bir içerik değil, bir üst katmandır. Siz kaldırana kadar filodaki tüm ekranları kaplar.
  • 99 · Kalıcı yayın (ekran sayfasından) — o ekrana dayatılan bir içerik; seçtiğiniz süre boyunca veya Durdur'a basana kadar. Zamanlamaları değiştirmeden onların önüne geçer.
  • 99 · Uzaktan kumanda, yayınlanan içerik — devam eden kalıcı yayının yerini alır (ekran başına yalnızca bir kalıcı içerik) ve zamanlamaların önüne geçer. Durdurmak yalnızca o ekranı etkiler; butona bağlı diğer ekranlar devam eder.
  • 99 · Uzaktan kumanda, zorlanan zamanlama — hiçbir içerik oluşturmaz: mevcut bir zamanlamayı en üst seviyeye zorlar. Kapatmak, yalnızca görüntülenen ekranı değil, bu zamanlamanın hedeflediği TÜM ekranları etkiler.
  • 0 ile 98 · Zamanlamalar — olağan yayın: saatler, günler, geçerlilik tarihleri. Ekran duvarı bir zamanlamayla yönetilir; dolayısıyla diğerleri gibi bu seviyede yarışır.

Aklınızda kalsın

  • Bir ekranda aynı anda yalnızca tek bir kalıcı içerik görünür: yeni bir yayın başlatmak o ekrandaki öncekinin yerini alır.
  • Zamanlamalarınız asla değiştirilmez: önlerine geçen şey durduğunda veya süresi dolduğunda kendiliğinden devreye girerler.
  • Üç kaynak 99. seviyeyi paylaşır. Eşitlik durumunda en eski olan kazanır: üst üste yığmak yerine istemediğinizi durdurun.
  • Acil durum uyarısı, doğrudan tüm filoya uygulanan tek kaynaktır — diğerleri ekran ekran ayarlanır.
  • Ekran sayfası her etkin kaynak için bir şerit gösterir: neyin yayınlandığını görür ve oradan durdurursunuz.

Ekranlar & eşleştirme

Bir ekranı eşleştirin

  1. 1

    Oynatıcıyı açın

    Ekranda Smart-Signage uygulamasını başlatın veya https://player.smart-signage.app adresini açın.

  2. 2

    PIN'i not edin

    6 haneli bir kod görünür, 10 dakika geçerlidir.

  3. 3

    Ekranı ekleyin

    Smart-Signage → Ekranlar → Ekle yolundan PIN'i ve ekranın adını girin.

  4. 4

    Bir oynatma listesi atayın

    Oynatma listesini veya zamanlamayı seçin. Yayın başlar.

Bir ekranın özellikleri

  • Ad, konum, kiracı, etiketler.
  • Algılanan çözünürlük ve yönlendirme (1920×1080, 1080×1920, 4K…).
  • Programlı uyku aralığı (örn. 22.00-06.00).
  • Ses seviyesi.

İzleme & uyarılar

Heartbeat

Her oynatıcı 30 saniyede bir sinyal gönderir: sürüm, durum, oynatılan liste, listedeki konum, sıcaklık (varsa), çalışma süresi, işletim sistemi sürümü, son oynatılan medya.

Ekran görüntüsü

İstek üzerine veya 5 dakikada bir programlı olarak alınır. Bir ekranın gerçekten olması gerekeni yayınladığını gözle doğrulamak için idealdir. Şifreli saklanır, 30 gün sonra silinir.

Uyarılar

  • Ekran çevrimdışı > 5 dk (yapılandırılabilir).
  • Depolama kotası sınıra yaklaştı.
  • Yayın hatası (bozuk medya, desteklenmeyen format).
  • Oynatıcı güncellemesi mevcut.

Kanallar: e-posta, webhook ve webhook üzerinden Slack/Teams.

API & webhook'lar

Premium pakette sunulur: otomasyon için bir REST API + webhook'lar — medya oluşturma, oynatma listesi tetikleme, olay alma. Erişim talep üzerine verilir, Bearer belirteci kiracı bazında kapsamlandırılır.

Örnek: bir flaş promosyonu gönderme

curl -X POST https://my.smart-signage.app/api/v1/playlists/promo-flash/activate \
  -H "Authorization: Bearer $SMARTSIGNAGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "tenantId": "maison-dupont",
    "duration": 1800,
    "devices": ["bellecour-vitrine", "confluence-mur"]
  }'

Gönderilen webhook'lar

  • device.offline — heartbeat göndermeyen ekran > eşik.
  • device.online — ekran yeniden çevrimiçi.
  • playlist.started / playlist.ended.
  • media.uploaded.
  • billing.threshold — faturalama kademesi aşıldı.

Güvenlik & uyumluluk

  • Barındırma — OVHcloud Roubaix & Strasbourg, veriler Fransa'da saklanır.
  • Şifreleme — aktarımda TLS 1.3, beklemede AES-256, anında iptal edilebilen ekran belirteçleri.
  • GDPR — DPA talep üzerine sunulur, işleme kayıt defteri güncel tutulur.
  • Yedeklemeler — günlük, 30 gün saklanır.
  • Denetim — tüm yönetim işlemlerinin kaydı, dışa aktarılabilir.

Oynatıcılar

Oynatıcı, ekranda çalışan uygulamadır. Mevcut donanımın %95'ini kapsayan üç sürüm sunulur.

Web Oynatıcı

Chrome / Edge / Firefox / Safari ≥ 2022

  • Kurulum gerektirmez
  • Otomatik güncellemeler
  • PWA olarak kurulabilir
  • Tarayıcıya bağımlı
  • Sistem uykusunu yönetmek gerekir
Önerilen

Android Oynatıcı

Android 9+ · Smart-Signage imzalı APK

  • Yerel kiosk modu
  • Sağlam çevrimdışı önbellek
  • Otomatik güncelleme
  • İlk kurulum gerektirir
Yakında

Tizen / WebOS Oynatıcı

Samsung & LG profesyonel TV'ler · 2024+

  • Harici kutu gerekmez
  • Üretici için optimize
  • Beta aşamasında
  • Sertifikasyon sürüyor

Web Oynatıcı — kurulum

  1. 1

    URL'yi açın

    https://player.smart-signage.app — hesap olmadan çalışır.

  2. 2

    Tam ekranı etkinleştirin

    F11 veya tarayıcının « Kiosk tam ekran » seçeneği.

  3. 3

    Uykuyu devre dışı bırakın

    Sistem → Güç → Asla uyku moduna geçme (ekran).

  4. 4

    PWA olarak kurun

    İsteğe bağlı: adres çubuğundaki simge → Kur. Ekran, yeniden başlatmada uygulamayı tekrar açar.

  5. 5

    Eşleştirin

    Görünen PIN'i Smart-Signage tarafında girin.

Android Oynatıcı — kurulum

  1. 1

    APK'yı indirin

    Smart-Signage → Ekranlar → Android oynatıcıyı indir (imzalı) yolundan.

  2. 2

    Bilinmeyen kaynaklara izin verin

    Ayarlar → Güvenlik → Bilinmeyen kaynaklar, yalnızca kurulum süresince.

  3. 3

    Kurun

    APK'yı dosya yöneticisinden veya ADB üzerinden açın.

  4. 4

    Kiosk modu

    Uygulama, açılışta ekranı Smart-Signage üzerinde kilitler. Çıkmak için: 6 haneli yönetici kodu.

  5. 5

    Eşleştirin

    PIN ekranda görünür. Smart-Signage tarafında girin.

Çevrimdışı mod

Web ve Android oynatıcılar, etkin oynatma listesini ve medyalarını önbellekte tutar. Ağ kesilirse:

  • Medyalar önbellekte olduğu sürece yayın devam eder.
  • Heartbeat kuyruğa alınır ve ağ geri geldiğinde gönderilir.
  • Küçük bir şerit « X dk'dır çevrimdışı » bilgisini verir (yalnızca kontrol panelinde, ekranda değil).

Güncellemeler

OynatıcıGüncelleme yöntemiSıklık
WebTarayıcı yenilemesinde otomatikSürekli
AndroidSmart-Signage imzalı OTAAylık (güvenlik: ihtiyaç hâlinde)
TizenÜretici mağazasıYakında

Önerilen donanım yapılandırması

KullanımCPURAMDepolama
1 Full HD ekranARM A53 veya x86 çift çekirdek2 GB16 GBWi-Fi N veya Ethernet
2×2 duvar veya 4KARM A76 veya x86 dört çekirdek4 GB32 GBEthernet önerilir
Ağır video / etkileşimlix86 i3 veya ARM A788 GB64 GB SSDGigabit Ethernet

Yanıtınızı bulamadınız mı?

Destek ekibi 24 iş saati içinde yanıt verir. Bunun dışında SSS ve destek rehberi sık karşılaşılan durumları kapsar.