取扱説明書

1 はじめに

ライブ配信で見えている映像は、配信者が実際にしゃべっている瞬間より必ず数秒遅れています。この遅れは回線が乱れるたびに増えていき、放っておいても縮みません。

Slipstream Live は、どれだけ先まで映像を読み込めているか（バッファ残量）を 1 秒間に約 50 回測り、再生速度をほんの少しだけ上げ下げすることで、映像を止めずに配信の「今」へ近づけ続けます。

インストール後は、視聴中に何か操作する必要はありません。

2 動作環境

3 インストール方法

3.1 Chrome / Edge / Brave など Chromium 系ブラウザ

Chrome ウェブストアからインストールします。

インストール後、ツールバーのパズルピースのアイコンから Slipstream Live を固定しておくと、アイコンが常に表示されて便利です。

3.2 Firefox

Firefox アドオンからインストールします。

3.3 ソースからインストールする場合（開発者・手動インストール向け）

Chromium 系ブラウザ

1. リポジトリを ZIP でダウンロードして解凍します（git clone でも構いません）。
2. アドレスバーに chrome://extensions と入力して開きます。
3. 画面右上の「デベロッパー モード」をオンにします。
4. 「パッケージ化されていない拡張機能を読み込む」をクリックし、解凍したフォルダ（manifest.json が入っている階層）を選びます。

Firefox — 一時的な読み込み（Firefox を閉じると消えます）

1. アドレスバーに about:debugging#/runtime/this-firefox と入力して開きます。
2. 「一時的なアドオンを読み込む…」をクリックします。
3. 解凍したフォルダ内の manifest.json を選択します。

Firefox — 恒久的なインストール（Developer Edition / Nightly 限定）

1. フォルダの中身を ZIP 圧縮します。
2. about:config で xpinstall.signatures.required を false に変更します。
3. about:addons の右上の歯車から「ファイルからアドオンをインストール…」で ZIP を選びます。

3.4 動作確認

1. YouTube・Twitch・ツイキャスのいずれかでライブ配信を開きます。アーカイブやクリップでは動作しません。
2. ツールバーの Slipstream Live アイコンをクリックします。
3. 「全サイト共通」パネルで「再生速度倍率を表示」をオンにします。
4. プレイヤーのコントロールバーに小さく 1.00x と表示され、動作に応じて色が変われば成功です。

4 各部の名称（設定画面）

ツールバーのアイコンをクリックすると設定画面が開きます。同じ画面は、ブラウザの拡張機能管理画面から「オプション」として独立したタブで開くこともできます。

• 変更は即時反映されます。保存ボタンはありません。
• 現在使われない項目はグレー表示になります。たとえば「バッファ閾値を自動調整する」が標準・積極的のとき、「加速するバッファ閾値（秒）」は操作できません。
• Twitch タブを選んでいるときだけ、既定値が大きい理由の注釈がパネル下部に表示されます。

5 バッジの見かた

3 種類のバッジはいずれも既定でオフです。「全サイト共通」パネルでオンにしてください。表示位置はプレイヤーのコントロールバー内で、コントロールバーが見つからない場合はプレイヤー左上の小さな黒い帯に切り替わります。

6 3 つの制御モード

優先度の高いモードが常に優先されます。Floor の 0.15x は安全装置なので、意図的に変更できないようにしてあります。

各しきい値には現在のモードへ留まる向きにヒステリシスが掛かっており、境界ちょうどで倍率と音量が細かく往復しません。幅は「バッファ閾値を自動調整する」の段階に連動し、オフ・標準では 0.1 秒、積極的では 0.05 秒です。

制御しないもの

• アーカイブ（VOD）・クリップ・広告再生中には一切手を出しません。ライブ再生中のみが対象です。
• ツイキャスの低遅延配信は対象外です。低遅延モードは WebRTC で映像が届くため、測定できる先読みバッファがなく、再生速度を変えても仕様上無視されます。そもそもほぼリアルタイムなので、詰めるべき遅れがありません。
• YouTube とツイキャスでは、あなたがプレイヤーのメニューで 1.00x 以外の速度を選んだ場合、Slipstream Live は制御を譲って手を引きます。速度を通常に戻せば自動制御が再開します。Twitch には速度変更メニューがないため常に Slipstream Live が制御し、あわせて Twitch 自身の追いつき機能が競合しないよう抑え込みます。

7 設定項目一覧

7.1 サイト別設定（サイトごとに別々に保存）

FF = Firefox での既定値。Firefox はバッファ残量の報告のされ方が異なるため、専用の値を持ちます。YouTube とツイキャスでは大きめ、Twitch では逆に小さめと、方向は一律ではありません。

7.2 「バッファ閾値を自動調整する」の 3 段階

7.3 全サイト共通設定

8 動作の仕組み

Slipstream Live は 20 ミリ秒ごとにバッファ残量（何秒先まで映像を読み込めているか）を測り、その値から 3 つのモードのどれかを選びます。

難しいのは「いつ加速して安全か」の判断です。バッファ残量は一定ではありません。映像は「セグメント」という数秒単位の塊で届くため、塊が届いた瞬間にドンと増え、再生とともにすーっと減っていきます。グラフにするとのこぎり波の形になります。たまたま山（ピーク）を見て「余裕たっぷり」と誤解して加速すると、直後の谷でバッファを使い切って映像が止まります。

そこで Slipstream Live は、1 回の測定値を信じる代わりに、配信ごとに自動調整される窓で谷の位置を統計的に推定し、その余裕が「確保したいバッファ量」を上回っている間だけ加速します。安全係数を大きく取っているため、谷が安定して同じ高さでないと余裕は生まれず、回線が不安定なときは自然と加速が抑制されます。データが足りない間は「わからないので何もしない」が自動的に成立します。

この判定の上に、ひとつだけ近道があります。残量が 20 秒（「最低速度する閾値」を大きくしている場合は「確保したいバッファ量＋10 秒」のうち高いほう）を超えている間は、谷の推定を待たずに加速し、15 秒を下回ると従来の判定へ戻ります。シーク直後はバッファの埋め直しが速すぎて統計が一時的に使えなくなるため、その場面でも反応を保つための仕組みです。近道が働くのは自動調整が「標準」「積極的」のときだけです。

バッジの再描画は毎秒 10 回までに抑えられ、統計もすべて平滑化されているため、速度が目に見えてばたつくことはありません。制御対象が見つからない間は 1 秒周期の探索モードへ落ち、やがてタイマーを完全に停止してメディアイベント待ちへ移ります。タブが表に戻った瞬間にも一度だけ実行されます。

9 困ったときは

10 デバッグログの取得方法

不具合を報告する際、デバッグログがあると原因の特定が容易になります。

1. 配信ページを開き、F12 でブラウザのコンソールを開きます。拡張機能のコンソールではありません。
2. 下の 1 行を実行します。
3. 症状が出ている状態で 30 秒ほど待ち、出力をコピーします。

1 秒ごとに、現在のモード・実再生速度・バッファ残量・短期統計・谷の統計・room の計算式・近道の基準値 ample・超過消費の累積 drift・定常判定 calm が出力されます。

• バッファ関連の数値が ---- の場合、値を取得できていない状態です。多くはバッファが空と報告されているためです。
• calm=NO が続く場合は定常でないと判定されており、谷の履歴が貯まらないため room も ---- になります。ただし残量が ample を超えている間は、その状態でも加速します。
• timer stopped は正常時も頻繁に出ます。全フレームに注入され、映像を持たないフレームは 5 秒で停止するためです。

11 プライバシー

Slipstream Live は外部との通信を一切行いません。要求する権限は次の 2 つだけです。

• storage — 設定を端末に保存するため。
• activeTab — ポップアップを開いたとき、対応サイトかどうかを判定して適切なタブを選ぶため。

解析・テレメトリ・識別子・広告は一切ありません。詳しくはプライバシーポリシーをご覧ください。

12 お問い合わせ

不具合報告時は、サイト・ブラウザとバージョン・拡張機能のバージョン・OS・起きたこと・再現手順・既定値から変更した設定、可能であればデバッグログを添えてください。

13 ライセンス

Apache License 2.0 または MIT License のデュアルライセンスです。どちらか好きな方を選んで利用できます。