![](\"https://user-images.githubusercontent.com/236501/85893648-1c92e880-b7a8-11ea-926d-95355b8175c7.png\")
@capacitor-community/native-audio
\n ⚡ Capacitor plugin for playing sounds natively.\n
\n\n\n ![](\"https://img.shields.io/maintenance/yes/2025?style=flat-square\")
![](\"https://img.shields.io/github/actions/workflow/status/capacitor-community/native-audio/ci.yml?branch=master&style=flat-square\")
![](\"https://img.shields.io/npm/l/@capacitor-community/native-audio?style=flat-square\")
\n ![](\"https://img.shields.io/npm/dw/@capacitor-community/native-audio?style=flat-square\")
![](\"https://img.shields.io/npm/v/@capacitor-community/native-audio?style=flat-square\")
![](\"https://img.shields.io/badge/all%20contributors-2-orange?style=flat-square\"){kind=icon}
ConfigureOptions |\n\n--------------------\n\n\n### preload(...)\n\n```typescript\npreload(options: PreloadOptions) => PromisePreloadOptions |\n\n--------------------\n\n\n### play(...)\n\n```typescript\nplay(options: { assetId: string; time?: number; }) => Promise{ assetId: string; time?: number; } |\n\n--------------------\n\n\n### pause(...)\n\n```typescript\npause(options: { assetId: string; }) => Promise{ assetId: string; } |\n\n--------------------\n\n\n### resume(...)\n\n```typescript\nresume(options: { assetId: string; }) => Promise{ assetId: string; } |\n\n--------------------\n\n\n### loop(...)\n\n```typescript\nloop(options: { assetId: string; }) => Promise{ assetId: string; } |\n\n--------------------\n\n\n### stop(...)\n\n```typescript\nstop(options: { assetId: string; }) => Promise{ assetId: string; } |\n\n--------------------\n\n\n### unload(...)\n\n```typescript\nunload(options: { assetId: string; }) => Promise{ assetId: string; } |\n\n--------------------\n\n\n### setVolume(...)\n\n```typescript\nsetVolume(options: { assetId: string; volume: number; }) => Promise{ assetId: string; volume: number; } |\n\n--------------------\n\n\n### getCurrentTime(...)\n\n```typescript\ngetCurrentTime(options: { assetId: string; }) => Promise<{ currentTime: number; }>\n```\n\n| Param | Type |\n| ------------- | --------------------------------- |\n| **`options`** | { assetId: string; } |\n\n**Returns:** Promise<{ currentTime: number; }>\n\n--------------------\n\n\n### getDuration(...)\n\n```typescript\ngetDuration(options: { assetId: string; }) => Promise<{ duration: number; }>\n```\n\n| Param | Type |\n| ------------- | --------------------------------- |\n| **`options`** | { assetId: string; } |\n\n**Returns:** Promise<{ duration: number; }>\n\n--------------------\n\n\n### isPlaying(...)\n\n```typescript\nisPlaying(options: { assetId: string; }) => Promise<{ isPlaying: boolean; }>\n```\n\n| Param | Type |\n| ------------- | --------------------------------- |\n| **`options`** | { assetId: string; } |\n\n**Returns:** Promise<{ isPlaying: boolean; }>\n\n--------------------\n\n\n### addListener('complete', ...)\n\n```typescript\naddListener(eventName: 'complete', listenerFunc: (event: { assetId: string; }) => void) => Promise'complete' |\n| **`listenerFunc`** | (event: { assetId: string; }) => void |\n\n**Returns:** Promise<PluginListenerHandle>\n\n**Since:** 5.0.1\n\n--------------------\n\n\n### Interfaces\n\n\n#### ConfigureOptions\n\n| Prop | Type | Description | Default |\n| ----------- | -------------------- | ------------------------------------------------- | ------------------ |\n| **`fade`** | boolean | Indicating whether or not to fade audio. | false |\n| **`focus`** | boolean | Indicating whether or not to disable mixed audio. | false |\n\n\n#### PreloadOptions\n\n| Prop | Type |\n| --------------------- | -------------------- |\n| **`assetPath`** | string |\n| **`assetId`** | string |\n| **`volume`** | number |\n| **`audioChannelNum`** | number |\n| **`isUrl`** | boolean |\n\n\n#### PluginListenerHandle\n\n| Prop | Type |\n| ------------ | ----------------------------------------- |\n| **`remove`** | () => Promise<void> |\n\n