← Dokumentacja

Automatyzacja transmisji

PanoPaper może powiadomić witrynę, system automatyki domowej, np. Home Assistant, usługę czatu, np. Slack lub Discord, albo skrót, gdy transmisja się zaczyna i kończy, podając link do oglądania - na przykład aby pokazać przycisk „Oglądaj na żywo” na własnej witrynie albo napisać na kanale Twojego zespołu.

Skonfiguruj to w oknie Gdy rozpoczynasz transmisję: przycisk z anteną znajdziesz na końcu kart serwisów w Ustawienia ▸ Transmisja. Gdy coś jest ustawione, antena jest kolorowa, a po wskazaniu przycisku widać, co jest włączone.

Webhook i skrót

Kiedy wysyłane są wiadomości

Wiadomość „live” jest wysyłana, gdy serwis przyjmie Twój strumień, i ponownie za każdym razem, gdy jakiś serwis dołączy lub odpadnie, a inny nadal nadaje; „stopped” - gdy zatrzyma się ostatni. Kliknięcie Zakończ transmisję w YouTube Studio nie zatrzymuje strumienia PanoPaper, więc nic nie jest wysyłane, dopóki nie zakończysz transmisji w PanoPaper.

Gdy Twoje konto YouTube jest połączone, wiadomość „live” dla YouTube zawiera też bezpośrednie linki do transmisji; PanoPaper czeka do pół minuty, aż YouTube zgłosi transmisję, zanim wyśle wiadomość. Podczas transmisji wiadomość „viewers” jest też wysyłana za każdym razem, gdy zmieni się liczba osób oglądających w YouTube; PanoPaper sprawdza ją co pięć minut.

Wiadomość

PanoPaper wysyła wiadomość jako żądanie HTTP POST z typem zawartości application/json, w UTF-8, z identyfikatorem klienta (user agent) PanoPaper/ i numerem wersji. Każda odpowiedź 2xx oznacza, że wiadomość dotarła, a treść odpowiedzi nie jest czytana. Każda próba czeka na odpowiedź do 15 sekund. Gdy sieć zawiedzie albo serwer odpowie 408, 429 lub 5xx, PanoPaper próbuje ponownie po 5 sekundach i jeszcze raz 30 sekund później; po innych odpowiedziach nie ponawia próby, a „Testuj” próbuje tylko raz. Wiadomości są wysyłane jedna po drugiej, w kolejności zdarzeń, więc „stopped” nigdy nie dotrze przed odpowiadającym mu „live”.

Wiadomość „live” dla YouTube i Facebooka, gdy Twoje konto YouTube jest połączone:

{
  "event" : "live",
  "services" : [
    "YouTube",
    "Facebook"
  ],
  "watch" : "https://www.youtube.com/@yourchannel/live",
  "videoId" : "AbCdEfGhIjK",
  "video" : "https://www.youtube.com/watch?v=AbCdEfGhIjK",
  "embed" : "https://www.youtube.com/embed/AbCdEfGhIjK",
  "camera" : "Port Dome",
  "time" : "2026-10-20T14:03:12Z",
  "text" : "Port Dome nadaje na żywo na YouTube i Facebook: https://www.youtube.com/watch?v=AbCdEfGhIjK",
  "content" : "Port Dome nadaje na żywo na YouTube i Facebook: https://www.youtube.com/watch?v=AbCdEfGhIjK"
}
Pole Typ Co zawiera
event ciąg znaków live, stopped, viewers lub test. Aby ustalić, co się stało, używaj tego pola, a nie text.
services tablica ciągów znaków Serwisy: YouTube, Facebook, a dla innego serwisu nazwa jego serwera, np. live.twitch.tv (nazwa dłuższa niż 20 znaków jest wysyłana jako „Własny serwer”, w języku PanoPaper). W „live” i „viewers” - wszystkie serwisy nadające w danej chwili; w „stopped” - te, które nadawały; w „test” - te gotowe do transmisji.
watch ciąg znaków (URL) Link do oglądania: strona transmisji na żywo Twojego kanału, https://www.youtube.com/@<channel>/live - albo, gdy konto jest połączone, a opcja „Ustawiaj transmisję jako publiczną” jest wyłączona, własna strona transmisji, bo transmisji niepublicznej nie ma na stronie transmisji na żywo Twojego kanału. Tylko gdy YouTube jest wśród serwisów i podano Kanał, a w „test” zawsze, gdy podano Kanał.
videoId ciąg znaków Identyfikator wideo transmisji w YouTube. Tylko gdy Twoje konto YouTube jest połączone i YouTube zgłosił już wideo: w „live”, „viewers” i „test”, nigdy w „stopped”.
video ciąg znaków (URL) Strona samej transmisji, https://www.youtube.com/watch?v=<videoId>. Wysyłane razem z videoId.
embed ciąg znaków (URL) Transmisja do pokazania na stronie internetowej, https://www.youtube.com/embed/<videoId>, jako adres elementu <iframe>. Wysyłane razem z videoId.
viewers liczba całkowita Ile osób ogląda w YouTube według liczenia YouTube. Tylko gdy Twoje konto YouTube jest połączone i PanoPaper już sprawdził, około minuty po rozpoczęciu transmisji: w „viewers”, a w „live” i „test”, gdy liczba jest znana; nigdy w „stopped”.
camera ciąg znaków Nazwa kamery taka, jaką pokazuje PanoPaper: kamera na antenie, a w „stopped” ostatnia, która była na antenie. Gdy kamery są pokazywane na zmianę, ta, która była na antenie w chwili wysłania wiadomości - przełączenie na następną kamerę nie wysyła wiadomości.
time ciąg znaków Kiedy wiadomość powstała, w formacie ISO 8601 i UTC, z dokładnością do sekundy: 2026-10-20T14:03:12Z.
text, content ciąg znaków Dwa razy to samo zdanie, w języku PanoPaper - w „live” z bezpośrednim linkiem do transmisji, jeśli jest znany, a w innym razie ze stroną transmisji na żywo Twojego kanału: text to, co Slack pokazuje jako wiadomość, content to, co pokazuje Discord. Zdanie jest przeznaczone dla ludzi i jego brzmienie może się zmienić, więc nie odczytuj z niego żadnych danych.

Pole bez wartości jest pomijane - nigdy nie jest wysyłane puste ani jako null. Pola mogą przychodzić w dowolnej kolejności, a przyszłe wersje PanoPaper mogą dodawać nowe pola: pomijaj te, których nie znasz.

Adres jako sekret

PanoPaper nie podpisuje wiadomości ani nie dodaje własnego hasła. Aby tylko PanoPaper mógł wysyłać wiadomości na Twój serwer, umieść sekret w samym adresie, np. długą losową ścieżkę lub token w parametrach zapytania - tak działają już na przykład adresy webhooków Home Assistant. Dlatego adres pozostaje w Twoim pęku kluczy.

Gdy odbiorcą jest skrót

Skrót otrzymuje ten sam JSON jako plik nazwany od zdarzenia, np. „PanoPaper live.json”.

Także Skróty i Siri mogą rozpoczynać i zatrzymywać transmisje.