MIDNIGHT TYPEWRITER v10 — 設定・使い方(固定保存用)
目標: PC・iPhoneの両方でGoogle Drive上の同じFLACと設定JSONを再生。5文字以上の部分一致、3文字の短い曲名の完全一致に対応。パソコンでは背景画像全体を画面に収める。ホーム画面に追加してもログイン状態を維持し、毎回のGoogle認証を避ける。
1. まず修正したもの
S.A.Dは内部でSADに変換。3文字の短い曲名はすべて入力したときだけ正解。長い曲名の通常ルールは5文字以上の部分一致のまま。- PC版(横幅960px以上)は左に縦長画像全体、右に曲情報と操作パネルを表示。画像が切れないようウィンドウの高さに応じて縮小。
- スマホでは縦画面レイアウトを維持。PWA(ホーム画面追加)とCloudflare Pages認証機能を追加。
assets/theme.pngが背景。今後画像差し替えだけならこのファイルを同名で交換し、再デプロイする。配置が違う写真にはtheme-config.jsの座標変更が必要。
2. 重要:アプリ化だけでは自動ログインにならない
以前のv9はブラウザのメモリ内にのみGoogleアクセストークンを保存していたため、再読み込み後にログインが必要だった。v10はCloudflare Pagesに認証用の小さな処理 _worker.js を追加し、Googleの長期認証情報(リフレッシュトークン)をCloudflareの秘密鍵で暗号化した HttpOnly / Secure Cookieに保持する。Googleへの再認証は通常不要になるが、Googleによる失効、Cookie削除、端末を変えたとき、90日以上未使用、審査や設定変更の場合は再認証が必要。
Google OAuthの公開ステータスが「テスト中」だと、リフレッシュトークンは通常7日で失効する。長期利用するには「本番環境」に変更すること。 本番環境への切り替えは音楽ファイルの公開ではない。
3. 一度だけ必要な初期設定(OneDrive/Azure/有料トライアル不要)
A. Google側の設定
- Google Auth Platform クライアント を開き、すでに使用している「ウェブ アプリケーション」のクライアントを選択。
- 承認済みのJavaScript生成元に、実際のCloudflare Pagesの公開元URL(例
https://midnight-radio.pages.dev)が登録されていることを確認。 - 承認済みのリダイレクトURIに、URLの末尾が必ず
/api/auth/callbackとなるアドレスを追加する。例https://midnight-radio.pages.dev/api/auth/callback。 - 同じ画面に表示されるクライアントIDとクライアントシークレットを手元に控える。クライアントシークレットをHTML/JavaScript/ZIPに記載しない。チャットにも貼らない。
- 以前のGoogle Drive APIと
https://www.googleapis.com/auth/drive.fileスコープをそのまま使う。別プロジェクトを作り直す必要はない。 - Google Auth Platform 対象 で公開ステータスを確認。7日ごとの認証を避ける場合は「本番環境」に変更する(Googleの条件に従う)。
B. Cloudflare側の設定(ブラウザで作業)
- Cloudflareダッシュボード → Workers & Pages → 既存のMIDNIGHT TYPEWRITER Pagesプロジェクトを選ぶ。
- Settings → Variables and Secrets → Add を開き、Production に次の4つを設定する。
| 変数名 | 入力する値 | 暗号化 |
|---|---|---|
APP_ORIGIN |
https://あなたのプロジェクト.pages.dev(末尾 / なし) |
不要 |
GOOGLE_CLIENT_ID |
Googleのウェブアプリ用クライアントID | 不要 |
GOOGLE_CLIENT_SECRET |
Googleのウェブアプリ用クライアントシークレット | Encryptをオン |
SESSION_SECRET |
ランダムな長い文字列(最低32文字) | Encryptをオン |
Windows PowerShellで SESSION_SECRET を生成する方法(この値は第三者に見せない):
$bytes = New-Object byte[] 32
[System.Security.Cryptography.RandomNumberGenerator]::Create().GetBytes($bytes)
[Convert]::ToBase64String($bytes)
表示されたBase64文字列を SESSION_SECRET に登録する。これを後から変更すると既存ログインはやり直しになる。
- 設定保存後、Deployments → Create deployment を開き、v10の公開用ZIPを上げて本番デプロイする。ZIPの直下には
index.htmlと_worker.jsがある。Cloudflare Pagesの_worker.js方式は、ダッシュボードからのDirect Uploadでも利用できる。 https://あなたのプロジェクト.pages.dev/api/healthを開き、"configured":trueが表示されればCloudflare側の設定が認識されている。configured:falseなら4つの設定値やProductionの選択を見直し、再デプロイする。エラー画面に秘密情報は表示されない。- アプリの画面に戻り☁ CONNECTを押してGoogleに許可する。成功後はCloudflare側の暗号化CookieからGoogleへのアクセスを更新できる。
C. PCとiPhoneで使う
- PCではChromeまたはEdgeで本番URLを開く。最初のログインだけ許可が必要。
- iPhoneではSafariで同じ本番URLを開き、共有メニュー → ホーム画面に追加。ホーム画面に追加したアプリを起動し、そこで一度だけGoogleログインする。Safari本体とホーム画面アプリはCookieが別の保存領域になることがある。
- 以降はホーム画面のアプリアイコンから起動。Googleの認証が有効な間は自動復元する。FLACはGoogle Driveで共有され、端末への再アップロードは不要。
S.A.D.flacの曲は文字盤で S → A → D → OK。XG - S.A.D.flacでも、ファイル名のXG -をアーティスト名と解釈して曲名はS.A.Dになる。すでに曲をアップロード済みなら再登録不要。SYNCで曲名を確認。
4. 料金・セキュリティ
- Google Drive無料15GBの範囲、Google Drive APIの無料利用枠、Cloudflare Pages/Functionsの無料利用枠で運用する方針。利用枠・規約が変更される可能性があるため、未来永劫の無料を保証するものではない。
- Googleのクライアントシークレットとセッション暗号鍵はCloudflareの暗号化されたSecretsにのみ保存。ZIPに秘密情報を入れない。リフレッシュトークンは暗号化済みのHttpOnly Cookie内に保存し、ブラウザJSやlocalStorageには保存しない。JSに渡すのは短期アクセストークンのみ。
- Google Driveの音源は公開せず、アプリのGoogleアカウント認証を経てアクセス。アプリのWeb画面自体のURLは非公開化していないため、URLを知る人は画面にアクセスできるが、認証なしにDrive上の音源を読めない。
- Googleのリフレッシュトークンが無効になったときは、もう一度Googleでログインが必要。
DISCONNECTはリフレッシュトークンを失効させる。
5. 失敗したときの確認
S.A.Dが判定失敗:v10がデプロイされているか確認。HINT/SYNCで表示がS.A.D(またはSAD)か確認。キーワードにほかの曲が複数ヒットしていないか確認。configured:false:Cloudflareの4設定が足りない。秘密鍵をZIPに入れない。auth_error=state:Cookie無効、SafariのCookie制限、短時間に複数タブで認証、ログイン開始から10分超など。再度CONNECTする。auth_error=token:クライアントシークレット・リダイレクトURI不一致、Google側の許可などを確認。- 毎回Googleの画面へ戻る:本番URLのCookieを許可。Google OAuthが「テスト中」だと通常7日で再許可が必要。APP_ORIGINと実際のURLの一致も確認。
- PC表示が縦長で切れる:画面幅が960px以上か確認。v10はPCなら左右2カラムで縦長画像を縮小して全体表示。
- アイコンから起動できない:Safariでホーム画面追加し直す。PWAはGoogleアカウントの管理情報そのものを端末に複製しない。
6. いつでもガイドを開く
アプリの上部にある GUIDE とフッターの 設定ガイド から見られる。直接 https://あなたのプロジェクト.pages.dev/guide.html をブックマークしてもよい。