快速入门

安装

你可以使用我们的 AI 辅助设置来安装插件。使用以下命令将 Capgo skills 添加到你的 AI 工具中：

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

然后使用以下 prompt：

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-jw-player` plugin in my project.

如果你更想手动设置，请运行以下命令安装插件，并按照下方各平台的说明操作：

npm install @capgo/capacitor-jw-player
npx cap sync

导入

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

快速入门

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

await JwPlayer.initialize({ licenseKey: 'YOUR_JW_LICENSE' });
await JwPlayer.play({ mediaUrl: 'https://cdn.example.com/stream.m3u8', mediaType: 'video' });

常见坑点

• 许可：使用前需要有效的 JW 许可 initialize().
• DRM：从后端传递 DRM 配置，切勿嵌入密钥。
• 音频：需与 @capgo/capacitor-audiosession 在 iOS 上协调。

API 概览

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 });

setVolume

设置音量大小

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

await JwPlayer.setVolume({ volume: 0.5 });

getPosition

获取媒体当前播放进度

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

const result = await JwPlayer.getPosition();
console.log(result);

getState

获取当前播放器状态

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

const result = await JwPlayer.getState();
console.log(result);

setSpeed

设置播放速度

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

await JwPlayer.setSpeed({ speed: 1 });

setPlaylistIndex

通过索引设置播放列表中的当前项

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

await JwPlayer.setPlaylistIndex({ index: 1 });

loadPlaylist

加载播放列表

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

await JwPlayer.loadPlaylist({ playlistUrl: 'https://example.com' });

loadPlaylistWithItems

加载包含项目的播放列表

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

await JwPlayer.loadPlaylistWithItems({ playlist: [] });

getAudioTracks

获取可用音频轨道

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

const result = await JwPlayer.getAudioTracks();
console.log(result);

getCurrentAudioTrack

获取当前音频轨道

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

const result = await JwPlayer.getCurrentAudioTrack();
console.log(result);

setCurrentAudioTrack

设置当前音频轨道

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

await JwPlayer.setCurrentAudioTrack({ index: 1 });

getCaptions

获取可用字幕

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

const result = await JwPlayer.getCaptions();
console.log(result);

getCurrentCaptions

获取当前字幕轨道

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

const result = await JwPlayer.getCurrentCaptions();
console.log(result);

setCurrentCaptions

设置当前字幕轨道

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

await JwPlayer.setCurrentCaptions({ index: 1 });

currentPlaylist

获取当前播放列表

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

const result = await JwPlayer.currentPlaylist();
console.log(result);

单一事实来源

本页面由插件的 src/definitions.ts生成。当上游的公共 API 发生变化时，请重新运行 sync。

从入门指南继续

如果你正在使用 快速入门 要规划 dashboard 和 API 操作，请将其连接到 使用 @capgo/capacitor-jw-player 关于使用 @capgo/capacitor-jw-player 中的原生能力， API 概览 关于 API Overview 中的实现细节， 简介 关于 Introduction 中的实现细节， API 密钥 有关 API Keys 的实现细节，以及 设备 有关 Devices 的实现细节。