Apple 손쉬운 사용 제어

Apple 단축어, AssistiveTouch, Streamable TTS 모니터로 안전하게 TTS를 제어하도록 설정하세요.

상황에 맞는 제어 선택하기

건너뛰기를 누르면 플레이어가 명령을 받는 즉시 현재 메시지를 중지합니다. 활성화와 비활성화는 기존의 TTS 메시지 허용 설정을 변경합니다.

비활성화해도 현재 재생 중이거나 대기 중인 음성은 중지되지 않습니다. 현재 메시지를 중지하려면 건너뛰기를 사용하세요. 인터넷 연결이 필요합니다.

1단계:인증 토큰 만들기

계정 소유자로 로그인하세요. 후원 → 설정 → Apple 손쉬운 사용 제어를 열고, TTS 제어용 인증 토큰 만들기를 선택하세요.

내 iPhone처럼 알아보기 쉬운 이름을 입력하세요. 토큰을 만들고 복사하세요. 전체 토큰은 한 번만 표시됩니다.

토큰을 다른 사람에게 공개하지 마세요. 토큰을 가진 사람은 토큰이 만료되거나 폐기될 때까지 TTS를 제어할 수 있습니다. 공유하는 단축어나 스크린샷에 토큰을 포함하지 마세요.

2단계:TTS 중지 단축어 만들기

단축어 앱에서 TTS 중지라는 단축어를 만드세요. URL 동작을 추가하고 https://platform.streamable.run/api/tts/skip 을 입력하세요.

URL의 콘텐츠 가져오기를 추가하고 URL 동작의 출력을 선택하세요. 설정을 펼쳐 메서드를 POST로 지정하세요. 요청 본문은 비워 두세요.

Authorization이라는 헤더를 추가하세요. 값으로 Bearer YOUR_AUTH_TOKEN을 입력하고, YOUR_AUTH_TOKEN을 자신의 토큰으로 바꾸세요. Bearer 뒤에는 공백을 하나 넣으세요.

3단계:명령 결과 표시하기

URL의 콘텐츠 가져오기 다음에 사전 값 가져오기를 추가하세요. 응답의 message 키 값을 읽고, 그 값을 알림 보기에 전달하세요.

Stop requested는 서버가 명령을 접수했다는 뜻입니다. 해당 플레이어들이 중지를 확인하면 모니터에 Playback stopped에 해당하는 재생 중지 상태가 표시됩니다.

고정된 성공 알림 대신 응답으로 받은 메시지를 사용하세요. 요청이 실패했을 때 단축어가 성공했다고 알리지 않도록 하세요.

4단계:활성화 및 비활성화 단축어 만들기

TTS 중지를 복제하고 이름을 TTS 비활성화로 바꾸세요. URL만 https://platform.streamable.run/api/tts/disable 로 변경하세요.

TTS 중지를 다시 복제하고 이름을 TTS 활성화로 바꾸세요. URL만 https://platform.streamable.run/api/tts/enable 로 변경하세요.

세 단축어 모두 POST와 동일한 인증 토큰을 사용합니다. URL만 바꾸면 됩니다.

5단계:AssistiveTouch 제스처에 단축어 연결하기

iPhone에서 설정 → 손쉬운 사용 → 터치 → AssistiveTouch를 열고 AssistiveTouch를 켜세요. 사용자 설정 동작에서 다음과 같이 단축어를 지정하세요.

  • 단일 탭 → TTS 중지
  • 이중 탭 → TTS 비활성화
  • 길게 누르기 → TTS 활성화

6단계:방송 전에 테스트하기

각 단축어를 한 번씩 직접 실행하세요. platform.streamable.run에 대한 예상된 접근 요청을 허용하세요. TTS 모니터를 열어 플레이어가 연결되어 있는지 확인하세요.

문제없는 내용으로 TTS 메시지를 재생하고 Kick을 여세요. AssistiveTouch를 한 번 탭해 메시지가 끝나기 전에 음성이 중지되는지 확인하세요.

두 번 탭해 TTS를 비활성화하고, 길게 눌러 활성화하세요. 각 설정 변경이 모니터에 표시되는지 확인하세요.

TTS 모니터 사용하기

후원에서 TTS 모니터 열기를 선택하세요. 모니터에서 재생 중인 메시지, 대기열, TTS 설정, 플레이어 연결 상태를 볼 수 있습니다.

관리 모더레이터, 장면 전환자, 도구 모더레이터는 자신의 Streamable 계정으로 로그인합니다. 스트리머의 인증 토큰은 필요하지 않습니다. 모니터를 열어도 오디오는 자동으로 재생되지 않습니다.

Bluetooth 스피커로 음성 재생하기

TTS를 재생하는 기기와 스피커를 페어링하세요. iPhone에서는 설정 → Bluetooth를 열고 스피커를 선택하세요.

단축어는 명령만 전송하며, 스피커로 음성을 보내지 않습니다. 원격 OBS 플레이어의 음성이 iPhone에서 자동으로 재생되는 것은 아닙니다.

휴대전화에서 재생하려면 소유자가 모니터에서 이 기기에서 오디오 재생을 선택하면 됩니다. 스피커에 연결된 휴대전화에서 모니터를 열어 두세요.

같은 휴대전화에서 Kick을 사용하기 전에 백그라운드 재생, 메시지 사이의 대기 시간, 화면 잠금, 재연결을 테스트하세요. 브라우저의 백그라운드 오디오가 중지되거나 일시 정지될 수 있습니다.

토큰 교체 또는 폐기하기

Apple 손쉬운 사용 제어에서 이름으로 토큰을 찾으세요. 토큰 폐기를 선택하면 해당 토큰을 사용하는 모든 단축어가 즉시 접근 권한을 잃습니다.

새 토큰을 만드세요. 세 단축어의 Authorization 헤더를 모두 업데이트하세요. 다음 방송 전에 각 단축어를 한 번씩 실행하세요.

토큰을 폐기해도 재생 중인 음성이나 TTS 설정은 바뀌지 않습니다. 토큰 목록에서 만료일과 마지막 사용 시점을 확인할 수 있습니다.

제어가 작동하지 않을 때

  • 토큰이 유효하지 않거나 만료되었다면 새 토큰을 만드세요. 세 단축어 모두 현재 Authorization 헤더를 사용하는지 확인하세요.
  • Stop requested가 표시되는데도 음성이 계속 나오면 모니터에서 플레이어 연결을 확인하세요. 플레이어를 다시 연결한 후 재시도하세요.
  • 비활성화 후에도 음성이 계속 나오면 건너뛰기를 사용하세요. 비활성화는 설정만 변경합니다. 스피커에서 소리가 나지 않으면 페어링된 재생 기기를 확인하세요.