방송 자동화

PanoPaper는 방송이 시작되고 끝날 때 시청 링크와 함께 웹사이트, Home Assistant 같은 홈 자동화, Slack이나 Discord 같은 채팅 서비스 또는 단축어에 알릴 수 있습니다. 예를 들어 자신의 웹사이트에 ‘라이브 보기’ 버튼을 표시하거나 팀 채널에 글을 올릴 수 있습니다.

라이브를 시작하면에서 설정하십시오. 설정 ▸ 방송의 서비스 탭 끝에 있는 안테나 버튼입니다. 설정된 항목이 있으면 안테나가 색으로 표시되며, 버튼을 가리키면 켜져 있는 항목이 표시됩니다.

웹훅과 단축어

‘웹훅 호출’ - PanoPaper가 웹 주소로 메시지를 보냅니다. 자신의 서버, Home Assistant 같은 홈 자동화 또는 웹훅을 받는 서비스로 보낼 수 있습니다. ‘설정…’을 클릭하여 주소를 입력하거나 붙여넣고, 바꾸려면 ‘편집…’을 클릭하십시오. 이런 주소에는 비밀 정보가 들어 있는 경우가 많아 주소는 키체인에 보관됩니다. ‘테스트’는 즉시 샘플 메시지를 보내고 서버의 응답을 보여 줍니다. 서버가 웹 페이지로 응답하면 그 주소는 웹훅이 아니라 웹사이트일 가능성이 높습니다.
‘단축어 실행’(웹 버전) - 아래에서 선택한 단축어를 같은 메시지를 입력으로 하여 실행합니다. 입력은 작은 JSON 파일이며, 단축어에서 사전으로 읽을 수 있습니다.

메시지가 전송되는 시점

‘live’ 메시지는 서비스가 스트림을 받는 즉시 전송되며, 다른 서비스가 방송을 계속하는 동안 서비스가 추가되거나 빠질 때마다 다시 전송됩니다. ‘stopped’는 마지막 서비스가 멈출 때 전송됩니다. YouTube Studio에서 스트림 종료를 클릭해도 PanoPaper의 스트림은 멈추지 않으므로, PanoPaper에서 방송을 중단할 때까지 아무것도 전송되지 않습니다.

YouTube 계정이 연결되어 있으면 YouTube의 ‘live’ 메시지에는 방송 자체의 링크도 포함됩니다. PanoPaper는 YouTube에서 동영상을 알려 줄 때까지 최대 30초 동안 기다린 후 메시지를 보냅니다. 라이브 중에는 YouTube에서 시청 중인 사람 수가 바뀔 때마다 ‘viewers’ 메시지도 전송됩니다. PanoPaper는 5분마다 확인합니다.

메시지

PanoPaper는 메시지를 HTTP POST로 보내며, 콘텐츠 유형은 application/json, 인코딩은 UTF-8, 사용자 에이전트는 PanoPaper/ 뒤에 버전이 붙은 형태입니다. 2xx 응답은 모두 수신된 것으로 간주되며, 응답 본문은 읽지 않습니다. 각 시도는 응답을 최대 15초 동안 기다립니다. 네트워크 오류가 발생하거나 서버가 408, 429 또는 5xx로 응답하면 PanoPaper는 5초 후에 다시 시도하고, 그로부터 30초 후에 한 번 더 시도합니다. 다른 응답에는 다시 시도하지 않으며, ‘테스트’는 한 번만 시도합니다. 메시지는 일이 일어난 순서대로 하나씩 전송되므로 ‘stopped’가 해당 ‘live’보다 먼저 도착하는 일은 없습니다.

YouTube 계정이 연결된 상태에서 YouTube와 Facebook에 대한 ‘live’ 메시지:

{
  "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이(가) YouTube 및 Facebook에서 라이브 중입니다: https://www.youtube.com/watch?v=AbCdEfGhIjK",
  "content" : "Port Dome이(가) YouTube 및 Facebook에서 라이브 중입니다: https://www.youtube.com/watch?v=AbCdEfGhIjK"
}

필드	유형	내용
`event`	문자열	`live`, `stopped`, `viewers` 또는 `test`. 무슨 일이 일어났는지 판단하려면 `text`가 아니라 이 필드를 사용하십시오.
`services`	문자열 배열	서비스: `YouTube`, `Facebook`, 그 밖의 서비스는 해당 서버의 이름(예: `live.twitch.tv`). 20자보다 긴 이름은 PanoPaper의 언어로 ‘사용자 설정 서버’로 전송됩니다. ‘live’와 ‘viewers’에서는 그 순간 방송 중인 모든 서비스, ‘stopped’에서는 방송 중이던 서비스, ‘test’에서는 라이브를 시작할 준비가 된 서비스입니다.
`watch`	문자열(URL)	시청 링크로, 채널의 라이브 페이지(`https://www.youtube.com/@<channel>/live`)입니다. 계정을 연결하고 ‘방송을 공개로 설정’을 끈 경우에는 일부 공개 방송이 라이브 페이지에 표시되지 않으므로 방송 자체의 페이지입니다. YouTube가 서비스에 포함되어 있고 채널이 입력되어 있을 때만 포함되며, ‘test’에서는 채널이 입력되어 있으면 항상 포함됩니다.
`videoId`	문자열	YouTube 방송의 동영상 ID. YouTube 계정이 연결되어 있고 YouTube에서 동영상을 알려 준 후에만 포함됩니다. ‘live’, ‘viewers’, ‘test’에 포함되며 ‘stopped’에는 포함되지 않습니다.
`video`	문자열(URL)	방송 자체의 페이지, `https://www.youtube.com/watch?v=<videoId>`. `videoId`와 함께 전송됩니다.
`embed`	문자열(URL)	웹 페이지에 표시하기 위한 방송, `https://www.youtube.com/embed/<videoId>`. `<iframe>`의 주소로 사용합니다. `videoId`와 함께 전송됩니다.
`viewers`	정수	YouTube에서 시청 중인 사람 수(YouTube 집계 기준). YouTube 계정이 연결되어 있고 PanoPaper가 확인한 후(방송 시작 후 약 1분)에만 포함됩니다. ‘viewers’에 포함되고, ‘live’와 ‘test’에는 숫자를 알고 있는 동안 포함되며, ‘stopped’에는 포함되지 않습니다.
`camera`	문자열	PanoPaper에 표시되는 카메라 이름. 방송 중인 카메라이며, ‘stopped’에서는 마지막으로 방송했던 카메라입니다. 카메라가 번갈아 방송될 때는 메시지를 보낸 시점에 방송 중이던 카메라이며, 다음 카메라로 전환되어도 메시지는 전송되지 않습니다.
`time`	문자열	메시지가 만들어진 시각. ISO 8601 형식의 UTC, 초 단위: `2026-10-20T14:03:12Z`.
`text`, `content`	문자열	같은 문장이 PanoPaper의 언어로 두 번 들어갑니다. ‘live’에서는 방송 자체의 링크를 알면 그 링크를, 모르면 채널의 라이브 페이지를 담습니다. `text`는 Slack이 메시지로 표시하는 필드이고, `content`는 Discord가 표시하는 필드입니다. 사람이 읽기 위한 문장이며 문구가 바뀔 수 있으므로, 여기서 정보를 읽어 내지 마십시오.

값이 없는 필드는 생략되며, 빈 값이나 null로 전송되지 않습니다. 필드는 어떤 순서로든 올 수 있으며, 이후 버전의 PanoPaper에서 필드가 추가될 수 있습니다. 모르는 필드는 건너뛰십시오.

주소를 비밀로 유지하기

PanoPaper는 메시지에 서명하거나 자체 암호를 추가하지 않습니다. PanoPaper만 서버에 메시지를 보낼 수 있게 하려면 긴 임의 경로나 쿼리 문자열의 토큰처럼 비밀 정보를 주소 자체에 넣으십시오. 예를 들어 Home Assistant의 웹훅 주소는 이미 그런 방식으로 작동합니다. 주소가 키체인에 보관되는 이유도 이 때문입니다.

단축어에서

단축어는 같은 JSON을 ‘PanoPaper live.json’처럼 이벤트 이름이 붙은 파일로 받습니다.

단축어 및 Siri로도 방송을 시작하고 중단할 수 있습니다.