Guida alla configurazione per il web

Questa pagina mostra come configurare l'ambiente di sviluppo per l'utilizzo di MediaPipe Tasks nelle applicazioni web JavaScript.

Piattaforme e versioni supportate

Per creare applicazioni web con MediaPipe Tasks, il tuo ambiente di sviluppo richiede quanto segue:

  • Browser Chrome o Safari
  • Un'applicazione web che utilizza Node.js e NPM. In alternativa, puoi utilizzare i tag script per accedere alle attività MediaPipe tramite una rete CDN (Content Delivery Network).

Dipendenze MediaPipe Tasks

MediaPipe Tasks fornisce tre librerie predefinite per visione artificiale, testo e audio. A seconda dell'attività MediaPipe utilizzata dall'app, importa la libreria visione artificiale, di testo o audio nel tuo progetto di sviluppo.

Attività relative all'IA generativa

Il modulo di IA generativa delle attività di MediaPipe contiene attività che gestiscono la generazione di immagini o testo. Per importare le librerie di IA generativa delle attività di MediaPipe, importa le seguenti dipendenze nel progetto di sviluppo.

API LLM Inference

L'attività di inferenza LLM MediaPipe si trova all'interno della libreria tasks-genai.

npm install @mediapipe/tasks-genai

Se vuoi eseguire il deployment su un server, puoi utilizzare un servizio di rete CDN (Content Delivery Network), come jsDelivr, per aggiungere il codice direttamente alla pagina HTML.

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

Attività relative alla vista

Il modulo visivo di MediaPipe Tasks contiene attività che gestiscono gli input di immagini o video. Per importare la libreria di visione artificiale Tasks di MediaPipe, importa la seguente dipendenza nel progetto di sviluppo.

npm install @mediapipe/tasks-vision

Se vuoi eseguire il deployment su un server, puoi utilizzare un servizio di rete CDN (Content Delivery Network), come jsDelivr, per aggiungere il codice direttamente alla pagina HTML.

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

Attività di testo

Il modulo di testo Attività MediaPipe contiene attività che gestiscono gli input di stringa. Per importare la libreria di testo delle attività di MediaPipe, importa la seguente dipendenza nel tuo progetto di sviluppo.

npm install @mediapipe/tasks-text

Se vuoi eseguire il deployment su un server, puoi utilizzare un servizio di rete CDN (Content Delivery Network), come jsDelivr, per aggiungere il codice direttamente alla pagina HTML.

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

Attività audio

Il modulo audio Tasks MediaPipe contiene attività che gestiscono gli input audio. Per importare la libreria audio delle attività di MediaPipe, importa la seguente dipendenza nel tuo progetto di sviluppo.

npm install @mediapipe/tasks-audio

Se vuoi eseguire il deployment su un server, puoi utilizzare un servizio di rete CDN (Content Delivery Network), come jsDelivr, per aggiungere il codice direttamente alla pagina HTML.

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

Configurazione BaseOptions

BaseOptions consente la configurazione generale delle API MediaPipe Task.

Nome opzione Descrizione Valori accettati
modelAssetBuffer I contenuti del file dell'asset modello come array di tipo Uint8Array. Uint8Array
modelAssetPath Il percorso dell'asset del modello da aprire e mappare in memoria. TrustedResourceUrl
Delegate Abilita l'accelerazione hardware tramite un delegato del dispositivo per eseguire la pipeline MediaPipe. Valore predefinito: CPU. [CPU,
GPU]

Risoluzione dei problemi

Per ricevere assistenza in merito a domande tecniche relative a MediaPipe, visita il gruppo di discussione o Stack Overflow per ricevere assistenza dalla community. Per segnalare bug o richiedere funzionalità, segnala un problema su GitHub.