YouTube
Macro Deck에 포함YouTube 실시간 채팅과 방송 통계를 표시하고, 제목과 태그를 바꾸고, 슈퍼 챗과 멤버에 반응하세요.
YouTube 채팅 위젯과 YouTube 스트림 통계 위젯
- YouTube 채팅 및 YouTube 스트림 통계 위젯
- 방송 제목, 설명, 태그 설정
- 라이브 시작, 방송 종료, 광고 시간 시작
- 슈퍼 챗, 슈퍼 스티커, 멤버십에 대한 트리거
- 직접 만든 Google Cloud 프로젝트와 할당량 사용
YouTube 연동은 YouTube 채널을 Macro Deck에 연결합니다. 라이브 방송의 상태를 변수로 보여 주고, 슈퍼 챗, 슈퍼 스티커, 멤버십에 대한 트리거를 실행하고, 위젯에 실시간 채팅을 표시해 관리할 수 있게 하며, 버튼으로 방송을 바꿉니다.
YouTube에는 Macro Deck이 모든 사용자를 위해 쓸 수 있는 공용 로그인이 없습니다. 직접 만든 Google Cloud 프로젝트를 통해 연결하며, 처음 한 번 10분 정도 걸립니다. 프로젝트는 무료이며 할당량과 권한은 오직 사용자의 것입니다.
할 수 있는 일
- 현재 방송의 실시간 채팅에 채팅 메시지를 보냅니다.
- 라이브 중인 방송의 제목, 설명, 태그를 바꾸거나, 라이브 중이 아니면 예정된 다음 방송의 것을 바꿉니다.
- 라이브 시작으로 예정된 다음 방송을 시작하고, 방송 종료로 끝내고, YouTube에 광고 시간을 요청합니다.
- YouTube 채팅 위젯에 실시간 채팅을 표시하고, 위젯에서 메시지 삭제, 채팅 참여자 타임아웃 또는 차단을 합니다.
- YouTube 스트림 통계 위젯에 라이브 여부, 시청자, 좋아요, 구독자, 제목, 방송 시간을 표시합니다.
활용 예:
- 다음 방송의 제목과 태그를 설정하는 방송 준비 버튼.
- YouTube에 60초 광고 시간을 요청하는 광고 시간 버튼.
- 슈퍼 챗에서 실행되어 작성자와 금액이 담긴 알림을 표시하는 흐름.
- 새 멤버에서 실행되어 채팅에 감사 메시지를 올리는 흐름.
동작 방식
Macro Deck은 라이브 중에 방송 상태를 약 1분마다, 채팅을 몇 초마다 읽습니다. 모든 읽기와 변경은 하루 10,000단위가 주어지는 Google Cloud 프로젝트의 할당량을 사용합니다. Macro Deck은 사용량을 셉니다. 할당량이 거의 다 쓰이면 채팅 업데이트를 멈추고 라이브 상태를 덜 자주 읽습니다. 할당량을 모두 쓰면 Google이 할당량을 초기화하는 태평양 시간 자정까지 라이브 상태와 채팅 업데이트를 멈춥니다.
채팅, 슈퍼 챗, 멤버십 이벤트는 방송이 라이브 중일 때만 들어옵니다. Macro Deck이 실행되지 않는 동안 일어난 이벤트는 나중에 실행되지 않습니다. 채널을 여러 개 연결할 수 있습니다. 모든 액션에는 채널 필드가 있고, 모든 트리거를 채널 하나로 한정할 수 있습니다.
준비물
- 인터넷에 연결된 Windows, macOS 또는 Linux의 Macro Deck 3
- 라이브 방송을 할 수 있는 YouTube 채널
- YouTube Data API v3가 사용 설정된 Google Cloud 프로젝트
- TVs and Limited Input devices 유형의 OAuth 클라이언트 ID와 클라이언트 보안 비밀
- 광고 시작에는 중간 광고를 표시할 수 있는 채널의 라이브 방송이 필요함
설정하기
1단계: Google Cloud 프로젝트 만들기
채널을 소유한 Google 계정으로 Google Cloud console을 열고 프로젝트를 만드세요. 예: Macro Deck. APIs & Services > Library에서 YouTube Data API v3를 검색하고 Enable을 클릭하세요.
2단계: 동의 화면 설정
APIs & Services > OAuth consent screen(새 콘솔에서는 Google Auth Platform)을 여세요. External을 선택하고 앱 이름과 이메일 주소를 입력한 뒤 저장하세요. Audience(또는 Test users)에서 채널을 소유한 Google 계정을 테스트 사용자로 추가하세요.
3단계: OAuth 클라이언트 ID 만들기
APIs & Services > Credentials를 열고 Create credentials > OAuth client ID를 클릭한 다음 애플리케이션 유형으로 TVs and Limited Input devices를 선택하세요. 다른 유형은 로그인할 때 거부됩니다. Google이 보여 주는 Client ID와 Client secret을 복사하세요.
4단계: Macro Deck에 클라이언트 입력
Macro Deck의 사이드바에서 연동을 클릭하고 YouTube를 클릭하세요. 개요 탭의 구성 섹션에서 구성 추가를 클릭하세요. 오른쪽 위의 스위치를 켜도 같은 대화 상자가 열리며, 설정을 마치면 연동이 켜집니다. YouTube 채널 연결 대화 상자에 클라이언트 ID와 클라이언트 비밀 값을 붙여 넣으세요. Google이 프로젝트에 더 많은 할당량을 준 경우에만 고급 설정을 켜고 **일일 할당량(단위)**에 입력하세요. 계속을 클릭하세요.
5단계: Google에서 접근 승인
이제 대화 상자에 기기 코드와 함께 Google에서 액세스 승인이 표시됩니다. Google을 열고 승인을 클릭하고, 채널을 소유한 계정으로 로그인하고, 코드를 입력하고, 채널을 고른 다음 접근을 허용하세요. Google이 앱이 확인되지 않았다고 경고하지만 직접 만든 프로젝트이므로 계속 진행하세요. Macro Deck으로 돌아와 계속을 클릭하세요. 구성 이름은 채널 이름을 따릅니다. 예: YouTube (My Channel). 대화 상자에 **설정이 완료되었습니다.**가 표시되면 완료를 클릭하세요.
6단계: 버튼에 YouTube 액션 추가
덱 페이지에서 사용할 버튼을 클릭하세요. 덱의 잠금이 해제되어 있어야 하며, 오른쪽 위 버튼에 잠금이라고 표시되어 있으면 해제된 상태입니다. 짧게 누르기가 선택된 상태로 편집기가 열립니다. + 액션 추가를 클릭하고 액션 추가 대화 상자 왼쪽에서 YouTube를 선택한 다음 방송 제목 설정 같은 액션을 고르세요. 채널을 고르고 제목을 입력한 다음 저장을 클릭하세요.
액션7
버튼에 넣거나 흐름에서 실행하세요.
- 채팅 메시지 보내기
- 현재 방송의 실시간 채팅에 최대 200자의 메시지를 올립니다.
- 방송 제목 설정
- 현재 방송의 제목을 바꾸거나, 라이브 중이 아니면 예정된 다음 방송의 제목을 바꿉니다.
- 방송 설명 설정
- 현재 방송 또는 예정된 다음 방송의 설명을 바꿉니다.
- 방송 태그 설정
- 현재 방송 또는 예정된 다음 방송의 태그를 대체합니다.
- 광고 시작
- 라이브 방송 중에 30초에서 3분까지의 광고 시간을 표시하도록 YouTube에 요청합니다.
- 라이브 시작
- 준비된 예정 방송 중 다음 방송을 시작합니다. 먼저 방송 소프트웨어를 시작하세요.
- 방송 종료
- 현재 라이브 방송을 끝냅니다.
트리거8
버튼이나 흐름이 이 이벤트에 반응할 수 있습니다.
- 방송 시작
- 채널이 라이브를 시작했습니다.
- 방송 종료
- 채널의 라이브 방송이 끝났습니다.
- 슈퍼 챗
- 누군가 슈퍼 챗을 보냈으며, 작성자, 금액, 통화, 댓글을 함께 제공합니다.
- 슈퍼 스티커
- 누군가 슈퍼 스티커를 보냈습니다.
- 새 멤버
- 누군가 채널 멤버가 되었거나 멤버십을 업그레이드했습니다.
- 멤버 마일스톤
- 멤버가 채팅에 멤버십 마일스톤을 공유했습니다.
- 선물한 멤버십
- 누군가 다른 시청자에게 멤버십을 선물했습니다.
- YouTube 이벤트(고급)
- 이 목록의 모든 YouTube 이벤트를 하나의 트리거로 제공하며, 유형으로 필터링할 수 있습니다.
변수8
버튼과 위젯에 이 값을 표시하거나 조건에 사용하세요.
youtube_<channel>_display_name- 채널 이름입니다.
youtube_<channel>_is_live- 채널이 라이브 중인지 여부입니다.
youtube_<channel>_stream_title- 라이브 방송의 제목입니다.
youtube_<channel>_viewer_count- 현재 시청자 수입니다. 시청자 수를 숨기면 비어 있습니다.
youtube_<channel>_like_count- 라이브 방송의 좋아요 수입니다.
youtube_<channel>_subscriber_count- YouTube가 반올림해 표시하는 채널 구독자 수입니다.
youtube_<channel>_uptime_seconds- 방송이 진행된 시간(초)입니다.
youtube_<channel>_stream_thumbnail_url- 방송의 썸네일입니다.
위젯2
위젯 선택기에서 덱에 추가하세요.
- YouTube 채팅
- 슈퍼 챗과 새 멤버를 포함해 현재 방송의 실시간 채팅을 표시합니다. 누르면 더 큰 대화 상자에서 채팅을 관리할 수 있습니다.
- YouTube 스트림 통계
- 라이브 여부, 시청자, 좋아요, 구독자, 제목, 방송 시간을 고른 스타일로 표시합니다.
자주 묻는 질문
왜 직접 만든 Google Cloud 프로젝트가 필요한가요?
YouTube에는 Macro Deck이 모든 사용자를 위해 쓸 수 있는 공용 로그인이 없습니다. 직접 만든 프로젝트를 쓰면 할당량과 권한이 오직 사용자의 것이 됩니다. 프로젝트는 무료입니다.
왜 매주 다시 로그인해야 하나요?
프로젝트의 동의 화면이 테스트 상태인 동안 Google은 7일마다 로그인을 끝냅니다. 그러면 연동에 로그인이 만료되었다고 표시됩니다. 같은 클라이언트 ID와 클라이언트 보안 비밀로 다시 연결하세요. 로그인 상태를 유지하려면 Google Cloud console에서 동의 화면을 게시하세요.
할당량이 다 떨어지면 어떻게 되나요?
Macro Deck은 라이브 상태와 채팅 업데이트를 멈추고, 연동 아래 YouTube 페이지에 YouTube 할당량 모두 사용됨이 표시됩니다. Google은 태평양 시간 자정에 할당량을 초기화하며, 그때 업데이트가 다시 시작됩니다. 액션은 Google이 거부할 때까지 계속 동작합니다.
라이브 시작이 방송을 시작하지 않는 이유는 무엇인가요?
라이브 시작은 스트림이 이미 YouTube에 도착하고 있는 예정된 다음 방송을 시작하므로, 먼저 방송 소프트웨어를 시작하세요. 자동으로 시작되는 방송과 YouTube 스튜디오의 Stream now는 이 액션이 아니라 YouTube가 시작합니다.
채팅 위젯에서 차단을 해제할 수 있나요?
현재 방송 중에 Macro Deck으로 한 차단만, Macro Deck이 다시 시작되기 전까지 해제할 수 있습니다. YouTube는 어떤 차단이 있는지 Macro Deck에 알려 주지 않으므로, 다른 차단은 YouTube 스튜디오에서 해제하세요.
인증 정보는 어디에 저장되나요?
클라이언트 보안 비밀과 토큰은 Macro Deck이 실행 중인 컴퓨터에 암호화되어 저장되며 Google로만 전송됩니다.
스트리밍의 다른 연동
OBS Studio
Macro Deck에 포함장면을 전환하고, 방송·녹화·오디오를 제어하고, OBS Studio에서 일어나는 일에 반응하세요.
Meld Studio
Macro Deck에 포함Meld Studio에서 장면을 전환하고 준비하며, 레이어, 효과, 오디오 트랙을 제어하고, 라이브를 시작하세요.
Streamlabs Desktop
Macro Deck에 포함Streamlabs Desktop에서 장면을 전환하고 방송, 녹화, 오디오 소스를 제어하세요.
Streamer.bot
Macro Deck에 포함Streamer.bot 액션을 실행하고, 채팅 메시지를 보내고, Streamer.bot이 보고하는 모든 이벤트에 반응하세요.
Twitch
Macro Deck에 포함Twitch 채팅과 방송 통계를 표시하고, 채팅을 관리하고, 투표와 광고를 실행하고, 팔로우·구독·레이드에 반응하세요.