Guia de configuração para Web

Esta página mostra como configurar seu ambiente de desenvolvimento para usar o MediaPipe Tarefas nos seus aplicativos da Web em JavaScript.

Plataformas e versões compatíveis

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

  • Navegador Chrome ou Safari
  • Um aplicativo da Web que usa Node.js e NPM. Como alternativa, use tags de script para acessar o MediaPipe Tasks por meio de 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 da tarefa do MediaPipe usada pelo aplicativo, importe a visão, o texto ou biblioteca de áudio ao seu projeto de desenvolvimento.

Tarefas da IA generativa

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

API LLM Inference

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

npm install @mediapipe/tasks-genai

Se quiser implantar em um servidor, você pode usar uma rede de fornecimento de conteúdo (CDN) serviço, como jsDelivr, para adicionar código diretamente ao 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 lidam com imagens ou vídeos de entrada. Para importar a biblioteca de visão do MediaPipe Tasks, importe o seguinte ao seu projeto de desenvolvimento.

npm install @mediapipe/tasks-vision

Se quiser implantar em um servidor, você pode usar uma rede de fornecimento de conteúdo (CDN) serviço, como jsDelivr, para adicionar código diretamente ao 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 importe a biblioteca de texto MediaPipe Tasks, importe a seguinte dependência para seu no seu projeto de desenvolvimento.

npm install @mediapipe/tasks-text

Se quiser implantar em um servidor, você pode usar uma rede de fornecimento de conteúdo (CDN) serviço, como jsDelivr, para adicionar código diretamente ao 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 importe a biblioteca de áudio MediaPipe Tasks e importe a seguinte dependência para em seu projeto de desenvolvimento.

npm install @mediapipe/tasks-audio

Se quiser implantar em um servidor, você pode usar uma rede de fornecimento de conteúdo (CDN) serviço, como jsDelivr, para adicionar código diretamente ao sua página HTML.

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

Configuração BaseOptions

A BaseOptions permite a configuração geral das APIs MediaPipe Task.

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

Solução de problemas

Para obter ajuda com questões técnicas relacionadas ao MediaPipe, visite a discussão group ou Stack Overflow (em inglês) para receber suporte de na comunidade. Para informar bugs ou solicitar recursos, registre um problema no GitHub (em inglês).