Appleのアクセシビリティ操作

Appleのショートカット、AssistiveTouch、StreamableのTTSモニターを使って、安全にTTSを操作する方法を設定します。

目的に合った操作を選ぶ

スキップすると、プレーヤーが指示を受け取った時点で現在のメッセージが止まります。有効・無効の操作は、既存の「TTSメッセージを許可」設定を変更します。

無効にしても、再生中や待機中の音声は止まりません。現在のメッセージを止めるには、スキップを使ってください。インターネット接続が必要です。

アカウント所有者としてログインします。「投げ銭」→「設定」→「Appleのアクセシビリティ操作」を開き、「TTS操作用の認証トークンを作成」を選択します。

「自分のiPhone」などの名前を入力します。トークンを作成してコピーしてください。トークン全体が表示されるのは、このときだけです。

トークンは他人に見せないでください。トークンを持つ人は、有効期限が切れるか無効化されるまでTTSを操作できます。共有するショートカットやスクリーンショットに含めないでください。

「ショートカット」で、「TTSを停止」という名前のショートカットを作成します。「URL」アクションを追加し、https://platform.streamable.run/api/tts/skip を入力します。

「URLの内容を取得」を追加し、「URL」アクションの出力を選択します。設定を展開し、方法を POST にします。リクエスト本文は空にしてください。

Authorization という名前のヘッダーを追加し、値に Bearer YOUR_AUTH_TOKEN と入力します。YOUR_AUTH_TOKEN を自分のトークンに置き換えてください。Bearer の後には半角スペースを1つ入れます。

「URLの内容を取得」の後に「辞書の値を取得」を追加します。応答から message キーの値を取得し、その値を「通知を表示」に渡します。

Stop requested は、サーバーが停止の指示を受け付けたことを意味します。対象のプレーヤーが停止を確認すると、モニターに Playback stopped に相当する停止完了の表示が出ます。

固定の成功メッセージではなく、応答で返されたメッセージを使ってください。リクエストが失敗したときに、ショートカットが成功を通知しないようにします。

「TTSを停止」を複製し、名前を「TTSを無効にする」に変更します。URLだけを https://platform.streamable.run/api/tts/disable に変更します。

「TTSを停止」をもう一度複製し、名前を「TTSを有効にする」に変更します。URLだけを https://platform.streamable.run/api/tts/enable に変更します。

3つのショートカットすべてでPOSTと同じ認証トークンを使用します。変更するのはURLだけです。

iPhoneで「設定」→「アクセシビリティ」→「タッチ」→「AssistiveTouch」を開き、AssistiveTouchをオンにします。「カスタムアクション」で、次のようにショートカットを割り当てます。

各ショートカットを手動で1回ずつ実行します。platform.streamable.run への想定したアクセス要求を許可してください。TTSモニターを開き、プレーヤーが接続されていることを確認します。

問題のない内容のTTSメッセージを再生し、Kickを開きます。AssistiveTouchを1回タップし、メッセージが読み終わる前に音声が止まることを確認します。

ダブルタップしてTTSを無効にし、長押しして有効にします。それぞれの設定変更がモニターに表示されることを確認してください。

「投げ銭」で「TTSモニターを開く」を選択します。モニターには、再生中のメッセージ、待機中のメッセージ、TTSの設定、プレーヤーの接続状態が表示されます。

管理者モデレーター、シーンスイッチャー、ツールモデレーターは自分のStreamableアカウントでログインします。あなたの認証トークンは必要ありません。モニターを開いても音声は自動再生されません。

TTSを再生する端末とスピーカーをペアリングします。iPhoneでは「設定」→「Bluetooth」を開き、スピーカーを選択します。

ショートカットは操作の指示だけを送信します。スピーカーへ音声を送ることはありません。別の端末のOBSプレーヤーで再生される音声が、自動的にiPhoneから流れるわけではありません。

スマートフォンで再生する場合、所有者はモニターで「この端末で音声を再生」を選択できます。スピーカーに接続したスマートフォンで、モニターを開いたままにしてください。

同じスマートフォンでKickを使う前に、バックグラウンド再生、メッセージ間の無音時間、画面ロック、再接続をテストしてください。ブラウザのバックグラウンド音声は停止や一時停止する場合があります。

「Appleのアクセシビリティ操作」で、名前を確認して対象のトークンを見つけます。「トークンを無効化」を選択すると、そのトークンを使うすべてのショートカットが直ちにアクセスできなくなります。

新しいトークンを作成し、3つのショートカットすべての Authorization ヘッダーを更新します。次の配信前に、各ショートカットを1回ずつ実行してください。

トークンを無効化しても、現在の音声は止まらず、TTS設定も変わりません。トークン一覧には有効期限と最終使用日時が表示されます。

トークンが無効または期限切れの場合は、新しいトークンを作成してください。3つのショートカットすべてで、最新の Authorization ヘッダーを使っていることを確認します。
Stop requested と表示されても音声が続く場合は、モニターでプレーヤーの接続を確認してください。プレーヤーを再接続してから、もう一度試します。
無効にしても音声が続く場合は、スキップを使ってください。無効化は設定の変更だけを行います。スピーカーから音が出ない場合は、ペアリングした再生端末を確認してください。