Pular para o conteúdo

Opções de inicialização

As opções de inicialização que as outras páginas não cobrem: extensões, o Privacy Sandbox e o resto da lista.

Mais opções de inicialização

  • extensions — uma lista de caminhos de diretórios de extensões descompactadas (gera --load-extension + --disable-extensions-except).
  • disablePrivacySandbox / disable_privacy_sandbox — defina como true para desligar as APIs do Privacy Sandbox (Topics, FLEDGE / Protected Audience, Shared Storage, Private Aggregation, Fenced Frames). Desativada por padrão desde a 0.23: a persona padrão se apresenta como Google Chrome, que traz todas elas. Ative-a só quando a persona for um Chromium sem serviços do Google. O WebUSB não é afetado.
  • agentTyping / agent_typing — o ritmo de digitação do agente (human, o padrão / fast / instant). Veja Agente.
  • tlsProfile — mantém o TLS ClientHello coerente com a versão do Chrome que a persona declara, para que a camada de rede acompanhe o UA (e não o TLS nativo do build). O padrão, "match-persona", segue brandVersion; "native" não mexe nele; "chrome-<major>" fixa uma versão major. Veja Flags de fingerprint.
  • platform: "android" — uma persona mobile no modo best-effort (toque, ponteiro coarse, tela/DPR de celular, WebGL Mali/Adreno, viewport de celular). Num motor de desktop, a renderização da GPU continua sendo de desktop — combine com a canvas bridge para ter coerência de renderização.
  • storageQuota, fingerprintProfile, canvasBridge, webrtcIp, acceptLanguage, disableGpuFingerprint, fingerprintNoise — veja Flags de fingerprint.

Opções mais novas (build licenciado)

Estas exigem o build licenciado (Grátis com GitHub ou Pro). A revisão do motor que cada uma exige aparece entre colchetes; num motor mais antigo, o SDK pula as de 152 r22 com um aviso, e o motor ignora as demais.

  • allowThirdPartyCookies / allow_third_party_cookies — permite cookies de terceiros, como o Chrome padrão faz. A base sem serviços do Google os bloqueia por padrão, o que quebra frames incorporados de login, pagamento e desafio que dependem deles. [152 r22]
  • transparentProxy / transparent_proxy — esconde o proxy dos headers das requisições e do timing da conexão (requisições HTTP simples não levam header de proxy; conexões via proxy reportam timing como o de uma conexão reutilizada). Exige um proxy. [152 r22]
  • fingerprintVoices: false / fingerprint_voices=False — mantém as vozes de síntese de fala desta máquina, em vez da lista da persona. [152 r22]
  • fingerprint: "off" — inicia sem nenhuma persona, para diagnosticar problemas. [152 r22]
  • socks5Udp / socks5_udp — leva o UDP do WebRTC por um proxy socks5://, para que voz, vídeo e conexões peer funcionem e continuem saindo pelo endereço do proxy. O proxy precisa permitir isso; muitos pools residenciais não permitem. [151 r17]
  • portableProfile / encryptionKey — perfis que você pode copiar entre máquinas (veja acima). [151 r14; Python & Node]
  • personaSchema: 2 / persona_schema=2 — um modelo de identidade opcional em que a tela e o chip gráfico combinam com o processador e a memória que a persona declara. Desativado por padrão, para que todo seed existente mantenha a sua identidade. Adicione realGpuHost / real_gpu_host só numa máquina com placa de vídeo real. [151 r19; Python & Node]
  • shaderDialect: "hlsl" — veja Dialeto de shader. [151 r15]
  • profile: "auto" — inicia com um fingerprint real capturado, escolhido para esta máquina, em vez de um seed; ajuste a escolha com profileSelect / profile_select. Python & Node. No Node, funciona com o launch() padrão, com launchPersistentContext() e com serve() a partir do SDK 0.31.1; a 0.31.0 e as anteriores exigiam ephemeralProfile: false e falhavam com serve().

Sem vínculo com um build específico do motor:

  • version / releaseChannel — escolhe um build; veja como escolher um build.
  • licenseKey / license_key / LicenseKey — a chave de licença, caso ela não esteja em CLEARCOTE_LICENSE_KEY nem em ~/.clearcote/license.key.
  • licenseThroughProxy / license_through_proxy (ou CLEARCOTE_LICENSE_THROUGH_PROXY=1) — envia as chamadas de licença pelo proxy da inicialização, em vez de saírem direto desta máquina.
  • ephemeralProfile / userDataDir no launch() — veja a nota em Pelo SDK, mais acima.
  • widevine: true — reprodução com DRM (nos dois builds); veja Widevine & DRM.
  • quiet — silencia os avisos de inicialização e a saída de progresso do SDK.