Bitfocus Companion과 Stream Deck으로 스크린 제어하기

Bitfocus Companion은 Elgato Stream Deck이나 웹 브라우저의 버튼을 제작 전체의 제어판으로 바꿔 주는 무료 소프트웨어입니다. Companion의 Screenbird 연결을 쓰면 버튼 한 번으로 장면이 모든 스크린에서 라이브가 되고, 라이브인 동안 버튼이 장면의 색상으로 켜집니다. 그 사이에는 스크린이 알아서 계속 동작합니다.

필요한 것:

  • Companion 4.3 이상
  • Screenbird의 API 토큰
  • 장면 버튼을 쓰려면: 장면이 켜져 있고 장면이 하나 이상 있어야 합니다. 방법은 장면으로 여러 스크린을 한 번에 전환하기 문서를 참고하세요. 장면이 없어도 Companion으로 스크린에 콘텐츠를 전송하고 중지할 수 있습니다.

API 토큰 만들기

  1. 설정 > 연결 메뉴로 이동하세요.
  2. API 토큰 아래에서 새 API 토큰 버튼을 클릭하세요.
  3. 토큰에 이름을 지정하세요. 예를 들어 행사장 이름이나 Stream Deck 이름이 좋습니다.
  4. 접근 권한 항목에서 스크린과 장면 제어 옵션을 고르세요.
  5. 토큰 만들기 버튼을 클릭하고 토큰을 복사하세요. 토큰은 한 번만 표시됩니다.

토큰은 만들 때 활성화되어 있던 팀에서 동작합니다. 다른 팀의 스크린을 제어하려면 먼저 그 팀으로 전환한 다음 별도의 토큰을 만드세요. Companion 연결마다 토큰을 하나씩 쓰세요.

토큰에 대한 자세한 내용은 API 토큰 문서를 참고하세요.

Companion에 Screenbird 추가하기

  1. Companion에서 Connections 메뉴로 이동해 Screenbird를 검색하고 추가하세요.
  2. API token 항목에 토큰을 붙여 넣고 저장하세요.
  3. 연결의 프리셋을 열고 버튼을 Stream Deck으로 끌어 놓으세요.

Screenbird 지원팀에서 다른 주소를 알려 주지 않는 한 API address 항목은 그대로 두세요.

Companion을 실행하는 컴퓨터는 api.screenbird.app으로 가는 포트 443의 아웃바운드 HTTPS와 보안 WebSocket(WSS) 접속이 필요합니다. 인터넷이 제대로 연결되어 있지 않으면 버튼이 동작하지 않습니다.

버튼

프리셋은 세 그룹으로 나뉩니다.

Scenes

  • Go: 장면마다 버튼이 하나씩 있으며, 장면의 색상입니다.
  • Stop: 장면마다 버튼이 하나씩 있으며, 그 장면을 일반 상태로 되돌립니다. 어두운 색이고, 장면 이름이 장면 색상의 밝은 톤으로 표시됩니다.

Control

  • STOP ALL 버튼은 모든 것을 일반 상태로 되돌립니다. 어두운 빨간색입니다.
  • NEXT 버튼은 마지막에 시작한 장면의 다음 장면을 시작합니다. 순서는 대시보드의 장면 순서를 따릅니다. 버튼에는 그 장면의 이름이 표시됩니다.

Screens

  • 스크린이나 서브 화면마다 stop 버튼이 하나씩 있습니다. 그 스크린에 장면이나 전송한 콘텐츠가 표시되는 동안 어두운 빨간색으로 바뀝니다.

장면 버튼의 색상으로 상태를 알 수 있습니다.

  • 어두운 색: 장면이 꺼져 있습니다.
  • 원래 색상: 장면이 포함된 모든 스크린에서 라이브입니다.
  • 절반 밝기: 장면이 일부만 라이브입니다. 일부 스크린이 다른 내용을 표시하고 있거나, 그 장면이 이전부터 일부 스크린에 남아 있습니다.
  • 호박색, 텍스트에 "(changed)" 표시: 장면이 라이브가 된 뒤에 수정되었습니다. 다시 누르면 변경 사항이 라이브가 됩니다.

버튼은 변경 사항을 바로 따라갑니다. 누군가 대시보드나 휴대폰에서 장면을 시작하거나 정해진 시간에 시작될 때도 마찬가지입니다. 새 장면이나 새 스크린은 프리셋에 자동으로 나타납니다.

액션

직접 만드는 버튼에 다음 액션을 쓸 수 있습니다.

  • Scene: go: 장면을 포함된 모든 스크린에 표시합니다. 장면이 라이브가 된 뒤에 바뀌었다면 다시 눌러서 변경 사항을 라이브로 만듭니다.
  • Scene: stop: 이 장면을 중지합니다. 해당 스크린은 자체 콘텐츠로 돌아갑니다.
  • Scene: next: 마지막으로 활성화한 장면의 다음 장면으로 넘어갑니다.
  • Stop all: 모든 장면과 전송한 콘텐츠를 중지합니다. 화면 공유는 계속 실행됩니다.
  • Screen: push content: 스크린 하나 또는 서브 화면 하나에 콘텐츠를 표시합니다. 지정한 분 동안 표시하거나 중지할 때까지 표시할 수 있습니다. 콘텐츠는 팀의 파일, 디자인, 앱, 분할 화면, 재생목록이 담긴 목록에서 고릅니다.
  • Screen: stop: 스크린 하나 또는 서브 화면 하나에서 전송한 콘텐츠나 장면을 중지합니다.

피드백

버튼의 모양을 바꾸려면 다음 피드백을 사용하세요.

  • Scene is live, Scene is partly live, Scene changed since it went live
  • Screen shows: 장면, 전송한 콘텐츠, 화면 공유 또는 일반 콘텐츠
  • Screen is online

변수

버튼 텍스트에 변수를 쓸 수 있습니다. 예: $(screenbird:last_scene). 연결의 이름을 바꿨다면 "screenbird" 대신 그 이름을 쓰세요.

  • last_scene: 마지막으로 활성화한 장면
  • next_scene: Scene: next 액션이 시작하는 장면
  • live_scenes: 라이브인 장면
  • screens_online와 screens_total: 온라인인 스크린 수와 전체 스크린 수

문제 해결

  • Authentication failure: 토큰이 유효하지 않거나 폐기되었습니다. 새 토큰을 만들어 연결 설정에 붙여 넣으세요.
  • Insufficient permissions: 토큰에 스크린 접근 권한이 없거나, 토큰을 만든 사람이 접근 권한을 잃었습니다. 스크린과 장면 제어 권한으로 토큰을 만드세요.
  • API address가 언급된 Connection failure: Screenbird가 아닌 다른 것이 응답하고 있습니다. 예를 들어 Wi-Fi 로그인 페이지이거나 주소가 잘못된 경우입니다. 네트워크와 API address를 확인하세요.
  • 사라지지 않는 Waiting for the live connection 또는 Live updates unavailable: 방화벽이나 프록시가 api.screenbird.app으로 가는 WebSocket 트래픽을 막고 있을 수 있습니다. 버튼은 계속 동작하지만, 버튼을 누른 뒤에야 색상이 갱신됩니다.
  • No active subscription: Screenbird 계정이 활성 상태가 아닙니다. 연결은 5 분마다 다시 확인합니다.
  • 장면 버튼이 없을 때: 장면이 꺼져 있습니다. 소유자가 설정 > 고급 메뉴에서 켜면 됩니다. 그러면 Companion을 다시 시작하지 않아도 버튼이 자동으로 나타납니다.

토큰 중지하기

설정 > 연결 메뉴에서 토큰 옆의 폐기 버튼을 클릭하세요. 그 토큰을 쓰는 모든 것이 즉시 멈춥니다. API 토큰 문서를 참고하세요.

© screenbird.app