跳过主要内容

音频会话 Capacitor 插件

配置 iOS 音频会话以支持后台播放、混合和路由控制

安装

bun add @capgo/capacitor-audio-session bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-audio-session
  • pnpm add @capgo/capacitor-audio-session
  • yarn add @capgo/capacitor-audio-session

指南

如何在 Capacitor 中使用音频会话

在设备上测试

下载 Capgo 应用程序,然后扫描 QR code

音频会话插件预览二维码 code

使用 @capgo/capacitor-audio-session

仅限 iOS 的插件,用于查询和控制音频会话输出,并监听路由变化和中断。

安装

bun add @capgo/capacitor-audio-session
bunx cap sync

bunx cap sync 将插件的本机 code 复制到您的本机项目中。每次升级插件后,请重新运行它。

导入

import { AudioSession } from '@capgo/capacitor-audio-session';

快速了解 API

方法 描述
currentOutputs 获取当前激活的音频输出路由。
overrideOutput 覆盖当前音频输出路由。

示例

currentOutputs()

获取当前激活的音频输出路由。

import { AudioSession } from '@capgo/capacitor-audio-session';

const result = await AudioSession.currentOutputs();
console.log(result);

overrideOutput()

覆盖当前音频输出路由。

import { AudioSession } from '@capgo/capacitor-audio-session';

const result = await AudioSession.overrideOutput('default');
console.log(result);

监听事件

addListener 返回一个句柄。调用 handle.remove() 当屏幕卸载时。

完整参考

继续使用 @capgo/capacitor-audio-session

如果您正在使用 使用 @capgo/capacitor-audio-session 以规划原生媒体和界面行为,连接它与 @capgo/capacitor-音频会话 查看 @capgo/capacitor-audio-session 获取开始 查看 Getting Started 使用 @capgo/capacitor-live-activities 查看 Using @capgo/capacitor-live-activities @capgo/capacitor-live-activities 查看 @capgo/capacitor-live-activities 使用@capgo/capacitor-视频播放器 使用@capgo/capacitor-视频播放器的原生能力

常见问题

音频会话插件FAQ

如何在Capacitor应用中安装音频会话插件?

运行“bun add @capgo/capacitor-audio-session”(或“npm install @capgo/capacitor-audio-session”),然后运行“bunx cap sync”,使iOS和Android项目捕获native code。在应用code中从“@capgo/capacitor-audio-session”中导入。

@capgo/capacitor-audio-session与React、Vue和Angular兼容吗?

是的。音频会话是一个Capacitor包,因此它与任何在Capacitor中运行的Web框架兼容,包括Ionic、React、Vue、Angular、Svelte和纯JavaScript。

哪个Capacitor版本支持@capgo/capacitor-audio-session?

Capgo插件遵循Capacitor的主要版本:使用与Capacitor主要版本匹配的插件主要版本(例如插件v8与Capacitor 8)。在GitHub README中列出的兼容性表格中可以找到支持的版本。

@capgo/capacitor-audio-session是否免费且开源?

是的。音频会话的源code在GitHub上公开,https://github.com/Cap-go/capacitor-audiosession/,并且该包从npm中免费安装。欢迎bug报告和pull请求。

是否可以在不经过App Store审查的情况下更新使用音频会话的code?

安装或升级插件会更改native code,因此需要新的商店构建。之后,JavaScript、HTML和CSS更改,调用插件的更改,可以立即通过Capgo实时更新发布。

不必等待应用程序审查就可以将音频会话更改推送到应用程序

一旦插件在您的商店构建中,Capgo实时更新将推送您的JavaScript、HTML和CSS更改给用户几分钟内。

开始使用Capgo