Guia de configuração para Web

Nesta página, mostramos como configurar seu ambiente de desenvolvimento para usar o MediaPipe Tasks nos seus aplicativos da Web JavaScript.

Plataformas e versões compatíveis

Para criar aplicativos da Web com o MediaPipe Tasks, seu ambiente de desenvolvimento exige o seguinte:

  • Navegador Chrome ou Safari
  • Um aplicativo da Web que usa Node.js e NPM. Como alternativa, é possível usar tags de script para acessar o MediaPipe Tasks por uma rede de fornecimento de conteúdo (CDN).

Dependências do MediaPipe Tasks

O MediaPipe Tasks oferece três bibliotecas pré-criadas para visão, texto e áudio. Dependendo do MediaPipe Task usado pelo app, importe a biblioteca de visão, texto ou áudio para o projeto de desenvolvimento.

Tarefas de IA generativa

O módulo de IA generativa do MediaPipe Tasks contém tarefas que processam a geração de imagens ou textos. Para importar as bibliotecas de IA generativa do MediaPipe Tasks, importe as dependências a seguir para seu projeto de desenvolvimento.

API LLM Inference

A tarefa de inferência de LLM do MediaPipe está na biblioteca tasks-genai.

npm install @mediapipe/tasks-genai

Se você quiser implantar em um servidor, use um serviço da rede de fornecimento de conteúdo (CDN), como o jsDelivr (link em inglês), para adicionar o código diretamente à sua página HTML.

<head>
  <script src="https://cdn.jsdelivr.net/npm/@mediapipe/tasks-genai/genai_bundle.cjs"
    crossorigin="anonymous"></script>
</head>

Tarefas de visão

O módulo de visão do MediaPipe Tasks contém tarefas que processam entradas de imagem ou vídeo. Para importar a biblioteca de visão do MediaPipe Tasks, importe a dependência a seguir para seu projeto de desenvolvimento.

npm install @mediapipe/tasks-vision

Se você quiser implantar em um servidor, use um serviço da rede de fornecimento de conteúdo (CDN), como o jsDelivr (link em inglês), para adicionar o código diretamente à sua página HTML.

<head>
  <script src="https://cdn.jsdelivr.net/npm/@mediapipe/tasks-vision/vision_bundle.js"
    crossorigin="anonymous"></script>
</head>

Tarefas de texto

O módulo de texto MediaPipe Tasks contém tarefas que processam entradas de string. Para importar a biblioteca de texto do MediaPipe Tasks, importe a dependência abaixo para o projeto de desenvolvimento.

npm install @mediapipe/tasks-text

Se você quiser implantar em um servidor, use um serviço da rede de fornecimento de conteúdo (CDN), como o jsDelivr (link em inglês), para adicionar o código diretamente à sua página HTML.

<head>
  <script src="https://cdn.jsdelivr.net/npm/@mediapipe/tasks-text/text_bundle.js"
    crossorigin="anonymous"></script>
</head>

Tarefas de áudio

O módulo de áudio do MediaPipe Tasks contém tarefas que processam entradas de som. Para importar a biblioteca de áudio do MediaPipe Tasks, importe a dependência a seguir para seu projeto de desenvolvimento.

npm install @mediapipe/tasks-audio

Se você quiser implantar em um servidor, use um serviço da rede de fornecimento de conteúdo (CDN), como o jsDelivr (link em inglês), para adicionar o código diretamente à sua página HTML.

<head>
  <script src="https://cdn.jsdelivr.net/npm/@mediapipe/tasks-audio/audio_bundle.js"
    crossorigin="anonymous"></script>
</head>

Configuração de BaseOptions

As BaseOptions permitem a configuração geral das APIs Task do MediaPipe.

Nome da opção Descrição Valores aceitos
modelAssetBuffer O conteúdo do arquivo de recurso do modelo como uma matriz do tipo Uint8Array. Uint8Array
modelAssetPath O caminho do recurso do modelo a ser aberto e mapeado na memória. TrustedResourceUrl
Delegate Permite a aceleração de hardware por meio de um delegado de dispositivo para executar o pipeline MediaPipe. Valor padrão: CPU. [CPU,
GPU]

Solução de problemas

Para receber ajuda com dúvidas técnicas relacionadas ao MediaPipe, acesse o grupo de discussão ou o Stack Overflow para receber suporte da comunidade. Para informar bugs ou solicitar recursos, registre um problema no GitHub.