# HINATA AI MUSIC — Sunoプレイヤー連携

本番サイト: https://hinatabokkuri-star.github.io/

Sunoの公式埋め込みを、本番サイトの再生・停止・シーク・音量・速度・次の曲・リピートと連携させる拡張です。対象は https://suno.com/embed/* のiframe内です。操作メッセージは https://hinatabokkuri-star.github.io の親フレームからのものだけ受け付けます。Cookie、認証情報、音声データは読み取りません。音声のダウンロード、録音、外部送信は行いません。

## Edgeに読み込む

1. Edgeで edge://extensions/ を開きます。
2. 「開発者モード」を有効にします。
3. 「展開して読み込み」を押し、E:\Claude\portfolio\suno-bridge を選びます。ZIPを使う場合は先に展開し、manifest.json のあるフォルダーを選びます。
4. 拡張「HINATA Suno player bridge」バージョン **0.2.0** が有効なことを確認し、本番サイトを再読み込みします。

本番でSuno曲を選ぶと連携を確認し、接続できたら公式プレイヤーの操作枠を隠します。サイト側の再生・停止・シーク・音量・速度・リピート・スリープタイマー・キューと、時刻付き歌詞を使えます。公式iframeは音声の再生に必要なので、画面外の小さな領域に残します。

拡張がない場合、接続が切れた場合、再生がブロックされた場合は公式プレイヤーを表示します。枠内の ▶ を押して再生が始まれば、サイト側の操作に戻ります。音楽ファイルの曲とSuno曲は同じキューに入れられます。Suno曲のクロスフェードは行いません。

既に旧版を読み込んでいる場合は、このフォルダーを更新後、拡張の管理画面で再読み込みを押します。ユーザースクリプト管理拡張を使う場合は bridge.user.js を登録し、iframe内でも動く設定にします。

## 歌詞の時刻合わせ

「ひと駅ぶんの逃避行」は、公式Song Editorが受信する `aligned_lyrics/v3` の文字・単語時刻を、元の76行の歌詞と全文一致を確認して取り込みました。歌詞カードとミニプレイヤーが再生時刻に追従し、歌詞行を押すとその少し手前から再生します。手動スクロール中は追従を一時停止し、「現在行へ」で戻れます。前奏・間奏・後奏には歌詞の強調を残しません。

自動解析の時刻には誤差があるため、特に間奏の境目を確認します。この曲では、最初の間奏に伸びたトークン173と、二度目の間奏の終わりに飛んだトークン348を時刻集計から外し、同じ行の残りの測定時刻を使いました。歌詞本文は一文字も省略していません。最初の間奏後の行は、先頭の「ひ」の正確な開始時刻を確定できず、次の「と」の時刻を採用しています。

次の曲でも音源をダウンロードせず、ログイン中の公式エディタが受信した歌詞応答だけを保存し、`scripts/suno_alignment_to_lrc.js` でLRCと行の終了時刻を作れます。認証情報を取得・保存する必要はありません。入力の全文が一致しない場合や、無効・重複した時刻は取り込みを停止します。省略トークンは個別に確認して明示指定する方式です。

```powershell
node scripts/suno_alignment_to_lrc.js alignment.json data/suno-test-lyrics.json output-base --duration=329.84 --omit-tokens=173,348
```

[テストページ](https://hinatabokkuri-star.github.io/suno-player-test.html)も引き続き使えます。配信を聴きながら歌詞行のボタンを押すと、実際の再生時刻がその行に付きます。時刻はブラウザーのlocalStorageに保存され、LRC保存でテキストとして取り出せます。未設定の行はLRCに含めません。これは個別の時刻を確認・修正するためのページです。

## データと制約

データ songs.json のスキーマ2では playback_type が file または suno です。Suno曲の file_url は null で、公式URLを suno_url / embed_url に持ちます。歌詞は lyrics_lrc / lyrics_parsed にあり、今回の曲は lyrics_parsed に行の終了時刻 end もあります。音声ファイルを必要とする利用側は playback_type が file の曲だけを選びます。

Suno曲はオンライン再生です。Sunoの埋め込み仕様変更時には拡張の修正が必要になる場合があります。スマートフォンのSafari/PWAでは、このEdge拡張による連携は有効になりません。
