取扱説明書

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 タブを選んでいるときだけ、既定値が大きい理由の注釈と、他の 2 サイトにはない「プレイヤーのエラーから自動復帰する」のスイッチがパネル下部に表示されます。

5 バッジの見かた

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

6 3 つの制御モード

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

各しきい値には現在のモードへ留まる向きにヒステリシスが掛かっており、境界ちょうどで倍率と音量が細かく往復しません。幅は全段階で 0.2 秒です。加えて、加速を始めるときだけは 2 秒の間隔を空けます。それ以外の遷移（加速からの離脱、Floor の出入り）は待たせません。介入を強める方向だけを慎重にし、弱める方向・安全側へ戻る方向は即座に反映する、という考え方です。判定に使う値そのものが揺れる以上、しきい値の幅だけでは往復を止めきれないためです。

止まったプレイヤーからの復帰

Twitch ではプレイヤーが番号付きのエラーで完全に停止することがあります。よく見かけるのは「エラー #3000」で、通常の対処はページの再読み込みですが、それではチャットの流れも読んでいた位置も失われます。Slipstream Live はこのエラーを検知し、代わりに Twitch 自身の再読み込みボタンを押します。ページはそのままなので、1 秒ほどで映像だけが戻ります。まず少し待って自動復帰を見守り、間隔を広げながら数回試したところで打ち切ります。終了した配信に延々と挑み続けないためです。既定はオンで、Twitch タブでオフにできます。

制御しないもの

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

7 設定項目一覧

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

FF = Firefox での既定値。Firefox はバッファ残量の報告のされ方が異なるため、専用の値を持ちます。現在これが効くのは Twitch だけです。

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

7.3 全サイト共通設定

8 動作の仕組み

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

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

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

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

ここまでは「加速して安全か」の話ですが、それとは別に「加速する意味があるか」も見ています。ライブ映像は実時間でしか作られないため、どれだけ速く再生してもバッファは 1.0 倍でしか埋まりません。貯金を使い切って配信の最先端に到達したあとも倍率を保つと、再生が次のセグメントの到着を追い越し、そのたびにコンマ数秒だけ止まります。均せば実効速度は 1.0 倍まで落ち、映像だけが数秒おきにカクつきます。止まるたびに読み込みが追いつくため、この状態はバッファ残量では検出できません。そこで Slipstream Live は「加速で詰められるはずだった秒数」と「実際に詰められた秒数」を 12 秒の窓で突き合わせ、後者が前者の半分に満たなければ加速を見送ります。遅延が一定量ぶん増えるか 30 秒経てば、見送りは解除されます。この一定量はサイトのセグメント長に連動するため、遅延の絶対値がサイトによって 10 倍以上違っても同じ意味になります。

バッジの再描画は毎秒 10 回までに抑えられ、統計もすべて平滑化されているため、速度が目に見えてばたつくことはありません。制御対象が見つからない間はタイマーを止めず、1 秒周期の見張りモードへ落ちます。広告は本編と同じ映像要素で再生され、終わってもメディアイベントを出さないためです。タブが表に戻った瞬間にも一度だけ実行されます。

9 困ったときは

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

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

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

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

• バッファ関連の数値が ---- の場合、値を取得できていない状態です。多くはバッファが空と報告されているためです。
• calm=NO が続く場合は定常でないと判定されており、谷の履歴が貯まらないため room も ---- になります。ただし残量が ample を超えている間は、その状態でも加速します。
• lat= はサイトが報告する遅延です。sd は 5 秒窓の標準偏差、jump は直前 1 秒での最大変化量を表します。実測では定常時の sd は 0.11 以下、jump は 0.2 未満に収まります。jump がこれを大きく超え続ける場合、遅延の測定ノイズが大きく、見送りの自動解除が意図せず頻発している可能性があります。
• gain= は「実際に詰められた秒数 / 詰められるはずだった秒数」です。右の値が 1 秒を超えているのに左が半分に届かないと FUTILE が付き、加速を見送っている状態になります。
• timer stopped は機能を OFF にしたことを意味します。再生中に現れることはありません。

11 プライバシー

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

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

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

12 お問い合わせ

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

13 ライセンス

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