__CAPGO_KEEP_0__

媒体会话 Capacitor插件

从锁屏和通知中心控制媒体播放

安装

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

指南

如何在Capacitor中使用媒体会话

在设备上测试

下载Capgo应用,扫描QRcode。

媒体会话插件预览二维码code

使用@capgo/capacitor-media-session

Capacitor插件来暴露设备的媒体会话控制

安装

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

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

导入

import { MediaSession } from '@capgo/capacitor-media-session';

API概览

方法 描述
setMetadata 设置当前播放媒体的元数据。
setPlaybackState 更新媒体会话的播放状态。
setActionHandler 注册媒体会话动作的处理程序。
setPositionState 更新活动媒体会话的位置状态。

示例

setMetadata()

设置当前播放媒体的元数据。

import { MediaSession } from '@capgo/capacitor-media-session';

await MediaSession.setMetadata({ album: 'album' });

setPlaybackState()

更新媒体会话的播放状态。

import { MediaSession } from '@capgo/capacitor-media-session';

await MediaSession.setPlaybackState({ playbackState: 'none' });

setActionHandler()

注册媒体会话动作的处理程序。

import { MediaSession } from '@capgo/capacitor-media-session';

await MediaSession.setActionHandler({ action: 'play' }, (details) => {
  console.log(details);
});

setPositionState()

更新活动媒体会话的位置状态。

import { MediaSession } from '@capgo/capacitor-media-session';

await MediaSession.setPositionState({
  duration: 1000,
  playbackRate: 1,
  position: 10,
});

全局参考

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

如果您正在使用 使用 @capgo/capacitor-media-session 为 @API/__CAPGO_KEEP_1__-media-session 连接它以 @capgo/capacitor-media-session 查看 @capgo/capacitor-media-session 的实现细节 开始使用 为开始使用的实现细节 API概述 为API概述的实现细节 简介 为简介的实现细节,并且 API密钥 为API密钥的实现细节。

常见问题

@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-media-session 的常见问题

如何在 Capacitor 应用中安装 Media Session 插件?

Run "bun add @capgo/capacitor-media-session" (or "npm install @capgo/capacitor-media-session"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-media-session" in your app code.

是否支持 @capgo/capacitor-media-session 与 React、Vue 和 Angular?

是。Media Session 是一个 Capacitor 包,因此它与任何运行在 Capacitor 内的 Web 框架都兼容,包括 Ionic、React、Vue、Angular、Svelte 和普通 JavaScript。

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

Capgo 插件遵循 Capacitor 的主要版本:使用与 Capacitor 主要版本匹配的插件版本(例如插件 v8 与 Capacitor 8)。兼容性表格在 GitHub README 中列出了维护的版本。

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

是。源码 code 在 GitHub 上公开,https://github.com/Cap-go/capacitor-media-session/,并且可以从 npm 免费安装。欢迎bug报告和pull请求。

是否可以在不经过 App Store 审核的情况下更新使用 Media Session 的 code?

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

不必等待应用程序审查就可以将媒体会话的更改推送到用户

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

开始使用Capgo