audio-playback

Sonilo オーディオ再生

システムのデフォルト出力デバイスからローカルのオーディオファイルを再生します。Sonilo のツールの中で、ネットワーク呼び出しを行わない唯一のツールです。完全にローカルで再生するため、生成直後に会話から離れずに結果を聴くのに便利です。

セットアップ： Sonilo MCP サーバーに接続するだけで利用できます。API キーは不要です（サーバー自体がまだ接続されていない場合は、setup-api-key を参照してください）。

クイックスタート

MCP ツール呼び出し

play_audio(input_file_path="~/Desktop/thunder.m4a")

REST、Python／JS SDK、CLI による同等の方法はありません。これは MCP サーバー専用のローカル再生機能であり、Sonilo API の呼び出しではありません。MCP ではなく SDK または CLI で統合する場合は、保存したファイルを、お使いの言語やプラットフォームで通常利用する方法でローカル再生してください。

ツール

ツール	説明
play_audio(input_file_path)	システムのデフォルトスピーカーからローカルのオーディオファイルを再生します。

パラメーター

パラメーター	型	備考
input_file_path	string	絶対パス、または SONILO_MCP_BASE_PATH からの相対パスです。.wav/.mp3/.m4a/.aac/.ogg/.flac に対応しています。

ワークフローのヒント

• 生成ツールの後に自然につなげられます。 text_to_music、text_to_sfx、video_to_music などが保存先のパスを返したら、そのパスに対して play_audio を呼び出すよう提案してください（「今作ったものを再生して」のような表現から意図が明らかな場合は、デフォルトで呼び出してください）。
• プラットフォームごとの再生方法： macOS では afplay を使用し、Linux では .mp3 に mpg123、それ以外には aplay を優先して使用します。Windows にはネイティブプレーヤーを使う処理がなく、常に Python パッケージの sounddevice／soundfile にフォールバックします。これは、Linux で mpg123 と aplay のどちらもインストールされていない場合と同じです。このフォールバックを使うには、システムに PortAudio ライブラリを別途インストールする必要があります（macOS では brew install portaudio、Debian／Ubuntu では sudo apt-get install libportaudio2）。このリポジトリのそれ以外の機能は PortAudio なしで動作します。
• ほかのすべてのツールと同じファイルアクセス制限が適用されます。SONILO_MCP_ALLOW_ANY_PATH=true が設定されていない場合、SONILO_MCP_BASE_PATH の外にあるパスは拒否されます。

エラー処理

ファイルが存在しない場合、認識可能なオーディオ形式ではない場合、制限対象のベースパスの外にある場合、またはプラットフォームで利用可能なプレーヤーがない場合にエラーが発生します。プレーヤーがない場合は、不足しているものを示すメッセージが表示されます。