LivePack V4 정책서
2026-09-02 기준

고객 서비스 내 라이브 재생

생성된 라이브 방송은 위캔디오 콘솔 밖, 고객 자체 서비스에서도 재생할 수 있어야 한다. 초기 버전 지원 범위: 임베드 코드 / 재생 URL / 라이브 URL / 라이브 썸네일 URL — 이를 "외부 서비스 재생 연동"으로 정의한다.

디바이스별 배포 설정 — 시청자의 단말기 유형마다 기본으로 재생되는 인코딩 타입을 고른다. 기본은 ABR (Adaptive Bitrate) 이고, 고정 출력을 고르면 그 출력으로 재생을 시작한다.

  • 단말기 구분은 PC · Windows / PC · macOS / Mobile · iOS / Mobile · Android 넷이다(비디오팩과 같다). 접근 제한(§12 디바이스 제한)의 셋보다 잘게 나눈다 — 제한은 플랫폼 단위로 막으면 되지만, 어느 출력을 먼저 줄지는 같은 PC 안에서도 Windows 와 macOS 의 재생 환경이 달라 따로 정할 수 있어야 한다.
  • 고를 수 있는 출력은 채널 타입이 정한다 — 일반 채널에 1080p 를 내놓으면 고를 수 없는 선택지가 된다.
  • 배포 형식(M3U8/MP4) 선택은 두지 않는다. IVS 라이브는 HLS 단일 출력이라 고를 것이 없다 (비디오팩은 VOD 라 이 선택이 성립한다).
  • (미확정) 채널 타입별 출력 목록은 추정값이다. 실제 IVS 출력과 대조하지 않았다 — 백엔드 연동 후 마스터 플레이리스트로 확정한다(channelSpec.ts RENDITIONS). 부록 B 참조.

재생 접근 제한전체 허용 / 허용 목록 / 차단 목록 세 방식이다(비디오팩 리뉴얼과 같다). 단 디바이스 제한은 예외로 허용 / 제한 선택이다 — 목록·차단 방식이 성립하려면 대상을 사용자가 채워야 하는데, 디바이스는 대상이 이미 셋으로 정해져 있어 채울 목록이 없다. 항목마다 켜고 끄면 될 일을 세 방식으로 감싸면 빈 목록 같은 없는 상태를 만들게 된다.

  • V3 라이브팩은 차단 목록만 있었고(block_domains · block_country_codes · block_device_*), 초기 V4 는 허용 목록만 있었다. 서로 반대라 한쪽 사양만 두면 다른 쪽을 표현할 수 없다.
  • 화면 구성은 비디오팩 리뉴얼 배포 설정 그대로다 — 디바이스별 배포 설정 → 디바이스 제한 → 지역 제한 → 도메인 제한 순으로 섹션 카드를 놓고, 각 카드는 제목 헤더 + 설명 + 선택지다. 제한을 켰을 때만 대상 입력과 목록이 딸린다.
  • 디바이스 제한은 디바이스별 재생 허용 / 재생 제한 라디오다. 대상은 PC · 애플 iOS · 구글 Android 셋 — V3 라이브팩(block_device_pc/_ios/_android)과 비디오팩이 똑같이 이 셋을 쓴다. 이름 바로 옆에 선택지를 두어 어느 줄의 값인지 눈으로 따라가지 않게 한다.
  • 대상은 칩 목록으로 보여주고 하나씩 지운다. 도메인은 입력 후 추가, 국가는 목록에서 고르면 바로 담긴다.
  • 저장은 마지막 섹션 아래에 둔다(비디오팩 배포 설정과 같은 자리).
  • 제한을 켜 놓고 대상이 비면 저장을 막는다 — 허용 목록이 비면 아무도 못 보고, 차단 목록이 비면 제한이 없는 것과 같다. 둘 다 사용자가 의도한 상태가 아니다. 디바이스는 이 규칙의 대상이 아니다(위 예외) — 대신 최소 하나는 재생 허용이어야 한다.
  • 디바이스 제한은 비디오팩에 없는 V3 라이브팩 고유 항목이라 그대로 유지한다. 최소 하나는 켜져 있어야 한다.

재생 정보는 송출 정보와 같은 탭에 둔다. "이 주소로 내보내고, 이 주소로 본다"가 한 화면에서 이어져야 하고, 현재 송출 화면(미리보기)도 그 탭에 있어 셋을 한자리에서 대조할 수 있다. 배포 설정 탭에는 접근 제한만 남는다.

QR 코드재생 URL 을 담고, 현재 송출 화면(미리보기) 바로 아래에 둔다 — 미리보기로 무엇이 나가는지 보고 QR 로 그 화면을 휴대폰에서 여는, 같은 방송을 확인하는 한 쌍이다. 비디오팩 리뉴얼은 외부 QR 서비스 이미지를 부르지만, 이 콘솔은 외부 호출 없이 그린다(app/utils/qr.ts).

  • 채널 생성 API·상태 조회 API 등 고객 서비스가 프로그램 방식으로 제어하는 기능은 초기 필수 범위에서 제외(§17 후속 검토).
  • 고객 서비스 내 사용자 인증·접근 권한은 고객사 보안 정책에 따른다.
  • 기본 보안은 V3 사양과 동일하게 허용된 디바이스·도메인·국가에서만 재생하도록 한다.
  • 스트리밍 URL 자체의 재생 인증·접근 제한(IVS Playback Authorization / Playback Restriction) 제공 여부는 별도 검토.