Chrome / Edge 拡張機能
WordPress プラグインに加えて、本プロジェクトでは Chrome / Edge ブラウザ拡張機能 Live2D Web Canvas も提供しています。これにより、どんなウェブページ でも右下にデスクトップマスコットを表示できます。WordPress プラグインとは 2 つの独立した製品 であり、アカウントは共通ですが設定は完全に分かれています。
1. インストール先
| ブラウザ | インストールリンク |
|---|---|
| Google Chrome | Chrome ウェブストア · "Live2D Web Canvas" を検索 |
| Microsoft Edge | Edge アドオン · "Live2D Web Canvas" を検索 |
インストールするとアドレスバー右側に拡張機能アイコンが表示されます。クリックするとポップアップ(クイックトグル)が開き、「オプション」を選ぶと完全な設定画面に入れます。
見つからない場合:Chrome / Edge のストア審査は地域によりブロックされることがあります。GitHub リリースページから
.crx/.zipをダウンロードし、開発者モードで手動インストールできます(リスクを理解したユーザー向け)。
2. アンインストール
| ブラウザ | 手順 |
|---|---|
| Chrome | アドレスバーに chrome://extensions → Live2D Web Canvas を見つける → 「削除」→ 確認 |
| Edge | アドレスバーに edge://extensions → Live2D Web Canvas を見つける → 「削除」→ 確認 |
または、アドレスバー右側の拡張機能アイコンを 右クリック → Chrome / Edge から削除。
アンインストール後、ブラウザは本拡張機能が chrome.storage および IndexedDB に保存していたすべてのデータ(設定、ログイントークン、ダウンロード済み V1 モデル)を一括で削除します。
3. できること / できないこと
できること:
- 訪問中の任意のサイトの右下に Live2D マスコットを表示します(ページ内容は読み取らず、現在のカーソル位置に基づき向き合うアニメーションを行うのみ — 詳細は プライバシーポリシー)。
- 古典的な V1 モデル(22 / 33、Pio / Tia、Shizuku、艦これ Murakumo、超次元海王星 など)を同梱しており、IndexedDB にダウンロードしてオフラインで使えます。
- 課金アカウントでログインすると、独自の
modelAPIを入力して V2(Cubism 4+)モデルをロードできます。 - ヘッドアンカー、スケール、マスコット位置、キャンバスサイズ、吹き出し頻度、ツールバーのボタンなどを調整できます。
できないこと:
- 訪問ページのコンテンツ、URL、Cookie、フォーム、ブラウザ履歴を読み取りません。
- マウスクリック、スクロール、キー入力を収集しません。
- 位置情報、IP アドレス、デバイスフィンガープリントを収集しません。
すべてのデータの取り扱いは ブラウザ拡張機能プライバシーポリシー を参照してください。
4. ログイン(V2 を使う場合のみ必要)
オプションページ → ログイン タブ → 「ウェブでサインイン」。https://www.live2dweb.com/SingleLogin にリダイレクトされ、サインインに成功するとページは自動で閉じ、アクセストークンが chrome.storage.local に書き込まれます。
- ログイン状態は ローカルのみ で、デバイス間で同期されません。
- 自発的にログインしたときのみネットワークリクエストが発生します。拡張機能は閲覧中のページの URL / タイトルを収集しません。
- ログアウトするとローカルのトークンが消去されます。
無料の V1 モデルだけを使う場合は ログイン不要 です。
5. モデル設定
オプションページ → 基本設定 → モデル → モデルソース は二者択一のドロップダウンです:
| モデルソース | 意味 | 課金? |
|---|---|---|
| ローカルモデル(V1) | 拡張機能内蔵の V1 カタログから、ダウンロード済みのモデル + テクスチャセットを選びます。先に「V1 モデルライブラリ」タブで使いたいモデルをダウンロードしてください。 | 無料 |
| カスタム URL(有料) | 自分の modelAPI を入力して V2(Cubism 4+)モデルをロードします。書き方は WordPress プラグインと同じ:直接 .json リンク、またはディレクトリルート / + modelDir リスト。 | ログイン + 課金が必要 |
5.1 V1 モデルライブラリ
オプションページ → V1 モデルライブラリ タブ:利用可能なすべての V1 モデルを 64×64 サムネイルとステータスバッジ付きで一覧します。「ダウンロード」をクリックするとモデルファイルがブラウザの IndexedDB に保存されます(どのサーバーにもアップロードされません)。
- マルチテクスチャ型(22 / 33 / Pio / Tia など):単一の
model.moc+ 複数のテクスチャセット。下方のテクスチャ ID プルダウンは*.textures.jsonを解析した結果です。 - マルチスキン型(超次元海王星 / 艦これ / Shizuku Talk など):各「スキン」が独立したサブモデル(それぞれ独自の
model.moc)。テクスチャ ID プルダウンにはサブディレクトリ名が並びます。
5.2 カスタム URL(V2)
課金アカウントでログイン後、モデルソースを「カスタム URL(有料)」に切り替えると、下方に modelAPI と modelDir の 2 つの入力欄が現れます。書き方は modelAPI / modelDir の書き方 を参照してください。
ブラウザ拡張機能には「本サイトにホスト / ホットリンク防止」の切り替えは ありません。拡張機能は
modelAPIから直接モデルをロードするため、CORS がchrome-extension://...または*を Origin として許可している必要があります。
6. その他の設定タブ
- 基本設定:有効化トグル、モデル、ヘッドアンカー(
headPos)、モデルスケール、マスコット位置(X/Y)、キャンバスサイズ。 - ツールバー設定:右下のツールボタン(スクリーンショット、切り替え、設定など)の表示切替。
- ヒントメッセージ:デフォルトのヒント文と発火頻度。
- 詳細設定:開発・デバッグ用。通常は触る必要はありません。
- V1 モデルライブラリ:上記参照。
7. WordPress プラグインとの関係
| 項目 | WordPress プラグイン | ブラウザ拡張機能 |
|---|---|---|
| 設置場所 | あなた自身の WP サイト | ユーザーのブラウザ、すべてのページ |
| 設定者 | サイト管理者(一度の設定でサイト全体に反映) | 各ユーザーが自分のブラウザで設定 |
| V1 モデルソース | プラグイン内蔵 + リモートワークショップ | 拡張機能内蔵(IndexedDB キャッシュ) |
| V2 カスタム URL | 課金 + 「本サイトにホスト」が選択可 | 課金、ローカルキャッシュなし(直接取得) |
| アカウント | 同じ live2dweb.com アカウント | 同じアカウントだが、認可トークンは共有されないため別途サインインが必要 |