跳转到正文

@capgo/capacitor-media-session

Capacitor 插件,用于暴露设备的媒体会话控制功能。

@capgo/capacitor-media-session 将您的 Capacitor 播放器接入操作系统 正在播放 界面:锁屏、通知控制、耳机以及 CarPlay 风格的遥控器。设置标题和封面,发布播放状态,并响应来自原生 UI 的播放、暂停、快进和跳过操作。

适用于播客、音乐、有声书和长视频,这些场景下用户期望通过硬件按钮进行控制。

平台实现
iOSWeb 实现适配器(navigator.mediaSession;不可用时拒绝)
Android媒体会话服务
Web 端媒体会话 API
  • setMetadata - 设置当前播放媒体的元数据。
  • setPlaybackState - 更新媒体会话的播放状态。
  • setActionHandler - 为媒体会话操作注册处理程序。
  • setPositionState - 更新活动媒体会话的位置状态。
方法描述
setMetadata设置当前正在播放的媒体元数据。
setPlaybackState更新媒体会话的播放状态。
setActionHandler为媒体会话操作注册处理器。
setPositionState更新当前活动媒体会话的位置状态。
getPluginVersion获取原生 Capacitor 插件版本。

此参考文档同步自 src/definitions.ts 中的 capacitor-media-session.

如果你正在使用 @capgo/capacitor-media-session 要规划 dashboard 和 API 操作,请将其连接到 使用 @capgo/capacitor-media-session 在“使用 @capgo/capacitor-media-session”中的原生功能 API 概览 关于 API Overview 中的实现细节, 简介 关于 Introduction 中的实现细节, API 密钥 有关 API Keys 的实现细节,以及 设备 有关 Devices 的实现细节。