本文へスキップ

起動オプション

ほかのページで扱っていない起動オプション：拡張機能、Privacy Sandbox、そのほかのオプションの一覧です。

その他の起動オプション

  • extensions — 展開済み拡張機能のディレクトリパスのリスト（--load-extension + --disable-extensions-except を出力します）。
  • disablePrivacySandbox / disable_privacy_sandbox — true にすると Privacy Sandbox の API（Topics、FLEDGE / Protected Audience、Shared Storage、Private Aggregation、Fenced Frames）を無効にします。0.23 以降はデフォルトでオフです。デフォルトのペルソナは Google Chrome として振る舞い、Google Chrome はこれらの API をすべて搭載しているためです。このオプションを有効にするのは、ペルソナが Google 依存を取り除いた Chromium の場合だけにしてください。WebUSB には影響しません。
  • agentTyping / agent_typing — エージェントのキー入力のテンポ（human（デフォルト）/ fast / instant）。エージェントを参照してください。
  • tlsProfile — TLS ClientHello をペルソナが名乗る Chrome のバージョンと整合させ、ネットワーク層を（ビルド本来の TLS ではなく）UA に合わせます。デフォルトの "match-persona" は brandVersion に従い、"native" は手を加えず、"chrome-<major>" はメジャーバージョンを固定します。フィンガープリントフラグを参照してください。
  • platform: "android" — ベストエフォートのモバイルペルソナ（タッチ、coarse ポインター、モバイルの画面/DPR、Mali/Adreno の WebGL、スマートフォンのビューポート）。デスクトップのエンジンでは GPU の描画はデスクトップのままなので、描画の整合性を取るには canvas ブリッジと組み合わせてください。
  • storageQuota、fingerprintProfile、canvasBridge、webrtcIp、acceptLanguage、disableGpuFingerprint、fingerprintNoise — フィンガープリントフラグを参照してください。

新しいオプション（ライセンスビルド）

以下のオプションにはライセンスビルド（「GitHub で無料」または Pro）が必要です。それぞれに必要なエンジンのリビジョンを角かっこ内に示しています。古いエンジンでは、152 r22 のオプションは SDK が警告を出してスキップし、それ以外はエンジンが無視します。

  • allowThirdPartyCookies / allow_third_party_cookies — 標準の Chrome と同じようにサードパーティ Cookie を許可します。Google 依存を取り除いたベースはデフォルトでこれをブロックするため、サードパーティ Cookie に依存する埋め込みのサインイン、決済、チャレンジのフレームが動作しなくなります。[152 r22]
  • transparentProxy / transparent_proxy — リクエストヘッダーと接続タイミングからプロキシの存在を隠します（平文 HTTP のリクエストにはプロキシヘッダーが付かず、プロキシ経由の接続は再利用された接続のようなタイミングを報告します）。プロキシが必要です。[152 r22]
  • fingerprintVoices: false / fingerprint_voices=False — ペルソナのリストではなく、このマシン本来の音声合成ボイスを使います。[152 r22]
  • fingerprint: "off" — トラブルシューティング用に、ペルソナなしで起動します。[152 r22]
  • socks5Udp / socks5_udp — WebRTC の UDP を socks5:// プロキシ経由で流します。これにより音声、ビデオ、ピア接続が動作し、しかも通信はプロキシのアドレスから出ていきます。プロキシ側で許可されている必要があり、住宅用プロキシのプールの多くは許可していません。[151 r17]
  • portableProfile / encryptionKey — マシン間でコピーできるプロファイル（前述）。[151 r14; Python & Node]
  • personaSchema: 2 / persona_schema=2 — 画面とグラフィックスチップを、ペルソナが名乗るプロセッサーとメモリに見合ったものにする、オプションのアイデンティティモデルです。デフォルトではオフなので、既存のシードはどれも今のアイデンティティのままです。realGpuHost / real_gpu_host は、実際のグラフィックスカードを搭載したマシンでのみ追加してください。[151 r19; Python & Node]
  • shaderDialect: "hlsl" — シェーダー方言を参照してください。[151 r15]
  • profile: "auto" — シードの代わりに、このマシン向けに選んだ、実機から取得したフィンガープリントで起動します。profileSelect / profile_select で調整できます。Python & Node。Node では SDK 0.31.1 以降、デフォルトの launch()、launchPersistentContext()、serve() で動作します。0.31.0 以前は ephemeralProfile: false が必要で、serve() では失敗していました。

エンジンのビルドに依存しないもの：

  • version / releaseChannel — ビルドを選びます。ビルドの選び方を参照してください。
  • licenseKey / license_key / LicenseKey — ライセンスキー（CLEARCOTE_LICENSE_KEY にも ~/.clearcote/license.key にもない場合）。
  • licenseThroughProxy / license_through_proxy（または CLEARCOTE_LICENSE_THROUGH_PROXY=1）— ライセンス関連の通信を、このマシンから直接ではなく、起動時に指定したプロキシ経由で送ります。
  • launch() の ephemeralProfile / userDataDir — 前述の「SDK を使う方法」の説明を参照してください。
  • widevine: true — DRM コンテンツの再生（両ビルドとも対応）。Widevine & DRM を参照してください。
  • quiet — SDK の起動時の警告と進捗の出力を抑制します。