Saltar al contenido principal
@capgo/capacitor-native-audio Renombrado Renombrado de @capgo/native-audio a @capgo/capacitor-native-audio. Multimedia Código abierto

Native Audio plugin Capacitor

Reproduce archivos de audio cortos con baja latencia usando el motor de audio nativo para juegos y apps

Instalar

bun add @capgo/capacitor-native-audio bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-native-audio
  • pnpm add @capgo/capacitor-native-audio
  • yarn add @capgo/capacitor-native-audio

Guía

Cómo usar Native Audio en Capacitor

Probar en el dispositivo

Descarga la app Capgo y escanea el QR code.

Vista previa del plugin Native Audio QR code

Uso de @capgo/capacitor-native-audio

Un plugin nativo para el motor de audio nativo.

Instalar

npm install @capgo/capacitor-native-audio
npx cap sync

Lo que expone este plugin

  • configure - Configura el reproductor de audio.
  • preload - Carga un archivo de audio.
  • playOnce - Reproduce un audio una vez con limpieza automática.
  • isPreloaded - Comprueba si un audio está precargado.

Ejemplo de uso

configure

Configura el reproductor de audio.

import { NativeAudio } from '@capgo/capacitor-native-audio';

await NativeAudio.configure({
  focus: false,
  background: false,
  ignoreSilent: false,
  showNotification: false,
  backgroundPlayback: false,
});

preload

Carga un archivo de audio.

import { NativeAudio } from '@capgo/capacitor-native-audio';

await NativeAudio.preload({
  assetPath: 'path/to/file',
  assetId: 'asset-id-123',
});

playOnce

Reproduce un audio una vez con limpieza automática.

import { NativeAudio } from '@capgo/capacitor-native-audio';

// Simple one-shot playback
await NativeAudio.playOnce({ assetPath: 'audio/notification.mp3' });

// Play and delete the file after completion
await NativeAudio.playOnce({
  assetPath: 'file:///path/to/temp/audio.mp3',
  isUrl: true,
  deleteAfterPlay: true
});

// Get the assetId to control playback
const { assetId } = await NativeAudio.playOnce({
  assetPath: 'audio/long-track.mp3',
  autoPlay: true
});
// Later, you can stop it manually if needed
await NativeAudio.stop({ assetId });

isPreloaded

Comprueba si un audio está precargado.

import { NativeAudio } from '@capgo/capacitor-native-audio';

const result = await NativeAudio.isPreloaded({
  assetPath: 'path/to/file',
  assetId: 'asset-id-123',
});
console.log(result);

Referencia completa

Continuar desde «Uso de @capgo/capacitor-native-audio»

Si estás usando Uso de @capgo/capacitor-native-audio para planificar el comportamiento de los medios nativos y la interfaz, conéctalo con @capgo/capacitor-native-audio para los detalles de implementación en @capgo/capacitor-native-audio, Primeros pasos para los detalles de implementación en Primeros pasos, Uso de @capgo/capacitor-live-activities para la capacidad nativa en Uso de @capgo/capacitor-live-activities, @capgo/capacitor-live-activities para el detalle de implementación en @capgo/capacitor-live-activities, y Uso de @capgo/capacitor-video-player para la capacidad nativa en Uso de @capgo/capacitor-video-player.

FAQ

FAQ del plugin Native Audio

¿Cómo instalo el plugin Native Audio en una app Capacitor?

Ejecuta "bun add @capgo/capacitor-native-audio" (o "npm install @capgo/capacitor-native-audio"), luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android detecten el code nativo. Impórtalo desde "@capgo/capacitor-native-audio" en el code de tu app.

¿Funciona @capgo/capacitor-native-audio con React, Vue y Angular?

Sí. Native Audio es un paquete Capacitor, así que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor soporta @capgo/capacitor-native-audio?

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-native-audio gratuito y open source?

Sí. El código fuente de code es público en GitHub: https://github.com/Cap-go/capacitor-native-audio/ y el paquete se instala gratis desde npm. Los reportes de bugs y pull requests son bienvenidos.

¿Puedo actualizar code que usa Native Audio sin pasar por la revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Lanza cambios de Native Audio sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo