← アプリに戻るPINNED GUIDE · v10

MIDNIGHT TYPEWRITER v10 — 設定・使い方(固定保存用)

目標: PC・iPhoneの両方でGoogle Drive上の同じFLACと設定JSONを再生。5文字以上の部分一致、3文字の短い曲名の完全一致に対応。パソコンでは背景画像全体を画面に収める。ホーム画面に追加してもログイン状態を維持し、毎回のGoogle認証を避ける。

1. まず修正したもの

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側の設定

  1. Google Auth Platform クライアント を開き、すでに使用している「ウェブ アプリケーション」のクライアントを選択。
  2. 承認済みのJavaScript生成元に、実際のCloudflare Pagesの公開元URL(例 https://midnight-radio.pages.dev)が登録されていることを確認。
  3. 承認済みのリダイレクトURIに、URLの末尾が必ず /api/auth/callback となるアドレスを追加する。例 https://midnight-radio.pages.dev/api/auth/callback。
  4. 同じ画面に表示されるクライアントIDとクライアントシークレットを手元に控える。クライアントシークレットをHTML/JavaScript/ZIPに記載しない。チャットにも貼らない。
  5. 以前のGoogle Drive APIと https://www.googleapis.com/auth/drive.file スコープをそのまま使う。別プロジェクトを作り直す必要はない。
  6. Google Auth Platform 対象 で公開ステータスを確認。7日ごとの認証を避ける場合は「本番環境」に変更する(Googleの条件に従う)。

B. Cloudflare側の設定(ブラウザで作業)

  1. Cloudflareダッシュボード → Workers & Pages → 既存のMIDNIGHT TYPEWRITER Pagesプロジェクトを選ぶ。
  2. 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 に登録する。これを後から変更すると既存ログインはやり直しになる。

  1. 設定保存後、Deployments → Create deployment を開き、v10の公開用ZIPを上げて本番デプロイする。ZIPの直下には index.html と _worker.js がある。Cloudflare Pagesの _worker.js 方式は、ダッシュボードからのDirect Uploadでも利用できる。
  2. https://あなたのプロジェクト.pages.dev/api/health を開き、"configured":true が表示されればCloudflare側の設定が認識されている。configured:false なら4つの設定値やProductionの選択を見直し、再デプロイする。エラー画面に秘密情報は表示されない。
  3. アプリの画面に戻り☁ CONNECTを押してGoogleに許可する。成功後はCloudflare側の暗号化CookieからGoogleへのアクセスを更新できる。

C. PCとiPhoneで使う

  1. PCではChromeまたはEdgeで本番URLを開く。最初のログインだけ許可が必要。
  2. iPhoneではSafariで同じ本番URLを開き、共有メニュー → ホーム画面に追加。ホーム画面に追加したアプリを起動し、そこで一度だけGoogleログインする。Safari本体とホーム画面アプリはCookieが別の保存領域になることがある。
  3. 以降はホーム画面のアプリアイコンから起動。Googleの認証が有効な間は自動復元する。FLACはGoogle Driveで共有され、端末への再アップロードは不要。
  4. S.A.D.flac の曲は文字盤で S → A → D → OK。XG - S.A.D.flac でも、ファイル名の XG - をアーティスト名と解釈して曲名は S.A.D になる。すでに曲をアップロード済みなら再登録不要。SYNCで曲名を確認。

4. 料金・セキュリティ

5. 失敗したときの確認

6. いつでもガイドを開く

アプリの上部にある GUIDE とフッターの 設定ガイド から見られる。直接 https://あなたのプロジェクト.pages.dev/guide.html をブックマークしてもよい。