跳转至正文

JW Player Capacitor 插件

嵌入 JW Player,实现支持广告和分析的专业视频流媒体播放

安装

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

指南

如何在 Capacitor 中使用 JW Player

在设备上测试

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

JW Player 插件预览 QR code

使用 @capgo/capacitor-jw-player

播放来自 jwplayer.com 的视频。

安装

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

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

导入

import { JwPlayer } from '@capgo/capacitor-jw-player';

API 概览

方法 描述
initialize 初始化 JW Player。
play 播放视频。
pause 暂停当前播放的媒体。
resume 继续播放当前暂停的媒体。
stop 停止当前播放的媒体。
seekTo 跳转到当前播放媒体的指定位置。
setVolume 设置音量级别。
getPosition 获取媒体当前播放位置。
getState 获取播放器当前状态。
setSpeed 设置播放速度。
setPlaylistIndex 通过索引设置播放列表中的当前项目。
loadPlaylist 加载播放列表。
loadPlaylistWithItems 加载包含项目的播放列表。
getAudioTracks 获取可用的音轨。
getCurrentAudioTrack 获取当前音轨。
setCurrentAudioTrack 设置当前音轨。
getCaptions 获取可用的字幕。
getCurrentCaptions 获取当前字幕轨道。
setCurrentCaptions 设置当前字幕轨道。
currentPlaylist 获取当前播放列表。

示例

initialize()

初始化 JW Player。

import { JwPlayer } from '@capgo/capacitor-jw-player';

await JwPlayer.initialize({ licenseKey: 'license-key-123' });

play()

播放视频。

import { JwPlayer } from '@capgo/capacitor-jw-player';

await JwPlayer.play({
  mediaUrl: 'https://example.com',
  mediaType: 'video',
});

pause()

暂停当前播放的媒体。

import { JwPlayer } from '@capgo/capacitor-jw-player';

await JwPlayer.pause();

resume()

继续播放当前暂停的媒体。

import { JwPlayer } from '@capgo/capacitor-jw-player';

await JwPlayer.resume();

stop()

停止当前播放的媒体。

import { JwPlayer } from '@capgo/capacitor-jw-player';

await JwPlayer.stop();

seekTo()

跳转到当前播放媒体的指定位置。

import { JwPlayer } from '@capgo/capacitor-jw-player';

await JwPlayer.seekTo({ time: 10 });

上表列出了 20 个核心方法。监听器、版本辅助函数以及每个方法的完整规范,请参阅 GitHub 仓库.

完整参考文档

从“使用 @capgo/capacitor-jw-player”继续

如果你正在使用 使用 @capgo/capacitor-jw-player 要规划原生插件工作,请将其与 @capgo/capacitor-jw-player 有关 @capgo/capacitor-jw-player 的实现细节, 快速入门 有关“入门指南”中的实现细节, Capgo 插件目录 查看 Capgo 插件目录中的产品工作流, Capgo 提供的 Capacitor 插件 有关 Capgo 开发的 Capacitor 插件的实现细节,以及 添加或更新插件 有关添加或更新插件的实现细节。

常见问题

JW Player 插件常见问题

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

运行 "bun add @capgo/capacitor-jw-player"(或 "npm install @capgo/capacitor-jw-player"),然后运行 "bunx cap sync",以便 iOS 和 Android 项目获取原生 code。在您的应用 code 中从 "@capgo/capacitor-jw-player" 导入它。

@capgo/capacitor-jw-player 支持 React、Vue 和 Angular 吗?

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

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

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

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

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

我可以更新使用 JW Player 的 code 而无需经过 App Store 审核吗?

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

无需等待应用审核,即可发布 JW Player 变更

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

开始使用 Capgo