跳转至正文

Mux Player Capacitor 插件

使用 Mux Player 播放自适应比特率视频,优化播放质量

安装

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

指南

如何在 Capacitor 中使用 Mux Player

在设备上测试

下载 Capgo App,然后扫描二维码 code。

Mux Player 插件预览二维码 code

使用 @capgo/capacitor-mux-player

使用原生 Mux Player SDK 在 iOS 和 Android 上播放视频。

安装

bun add @capgo/capacitor-mux-player
bunx cap sync

bunx cap sync 将插件的原生 code 复制到你的原生项目中。每次升级插件后都要重新运行。

导入

import { MuxPlayer } from '@capgo/capacitor-mux-player';

API 概览

方法 描述
play 以全屏模式启动原生 Mux Player 并开始播放。
dismiss 如果播放器当前可见,则将其关闭。
isActive 返回播放器当前是否正在显示。

示例

play()

以全屏模式启动原生 Mux Player 并开始播放。

import { MuxPlayer } from '@capgo/capacitor-mux-player';

await MuxPlayer.play({ playbackId: 'playback-id-123' });

dismiss()

如果播放器当前可见,则将其关闭。

import { MuxPlayer } from '@capgo/capacitor-mux-player';

await MuxPlayer.dismiss();

isActive()

返回播放器当前是否正在显示。

import { MuxPlayer } from '@capgo/capacitor-mux-player';

const result = await MuxPlayer.isActive();
console.log(result);

监听事件

addListener 会返回一个句柄。调用 handle.remove() 在屏幕卸载时,或者调用 MuxPlayer.removeAllListeners() 以清除所有监听器。

完整参考文档

继续阅读“使用 @capgo/capacitor-mux-player”

如果你正在使用 使用 @capgo/capacitor-mux-player 来规划原生媒体和界面行为,并将其与 @capgo/capacitor-mux-player 查看 @capgo/capacitor-mux-player 中的实现细节, 快速入门 有关“入门指南”中的实现细节, 使用 @capgo/capacitor-live-activities 用于使用 @capgo/capacitor-live-activities 时的原生能力, @capgo/capacitor-live-activities 关于 @capgo/capacitor-live-activities 中的实现细节,以及 使用 @capgo/capacitor-video-player 有关“使用 @capgo/capacitor-video-player.”中的原生能力

常见问题

Mux Player 插件常见问题

如何在 Capacitor 应用中安装 Mux Player 插件?

运行 "bun add @capgo/capacitor-mux-player"(或 "npm install @capgo/capacitor-mux-player"),然后运行 "bunx cap sync",让 iOS 和 Android 项目引入 native code。再在应用 code 中从 "@capgo/capacitor-mux-player" 导入。

@capgo/capacitor-mux-player 是否支持 React、Vue 和 Angular?

支持。Mux Player 是一个 Capacitor 包,因此它适用于任何在 Capacitor 中运行的 Web 框架,包括 Ionic、React、Vue、Angular、Svelte 以及纯 JavaScript。

@capgo/capacitor-mux-player 支持哪个 Capacitor 版本?

Capgo 插件遵循 Capacitor 的主版本号:请使用与 Capacitor 主版本号一致的插件主版本(例如插件 v8 对应 Capacitor 8)。GitHub README 中的兼容性表列出了仍在维护的版本。

@capgo/capacitor-mux-player 是开源免费的吗?

是的。code 的源码已在 GitHub 公开,地址为 https://github.com/Cap-go/capacitor-mux-player/,也可以直接从 npm 免费安装。欢迎提交 Bug 报告和 Pull Request。

更新使用 Mux Player 的 code 可以不经 App Store 审核吗?

安装或升级插件会改动原生 code,因此需要重新做一次商店构建。之后,调用该插件的 JavaScript、HTML 和 CSS 改动就能通过 Capgo live updates 立即发布。

无需等待 App Store 审核,即可即时发布 Mux Player 更新

只要插件已包含在你的商店版本中,Capgo live updates 就能在几分钟内把 JavaScript、HTML 和 CSS 的改动推送给用户。

开始使用 Capgo