fb.player 播放控制

play()

开始播放。如果已暂停则恢复播放，已停止则从头开始。返回 {success}。

await fb.player.play();

pause()

暂停播放。返回 {success}。

await fb.player.pause();

stop()

停止播放。返回 {success}。

await fb.player.stop();

next() / prev()

播放下一首/上一首。返回 {success}。

await fb.player.next();
await fb.player.prev();

seek(seconds)

跳转到指定位置。

参数	类型	说明
seconds	number	目标位置（秒）

await fb.player.seek(90); // 跳转到 1 分 30 秒

getVolume()

获取当前音量。返回 Promise<{volume, volumeDb, muted}>，其中 volume 范围 0-100。

const info = await fb.player.getVolume();
console.log(info.volume);   // 0-100
console.log(info.volumeDb); // -100..0 dB
console.log(info.muted);    // boolean

setVolume(volume)

设置音量。

参数	类型	说明
volume	number	音量百分比 (0-100)

await fb.player.setVolume(80); // 80%
await fb.player.setVolume(0);  // 静音

mute()

静音。已静音时无操作。如需切换静音，请使用底层 API playback.toggleMute。

await fb.player.mute();

toggle()

切换播放/暂停。返回 {success, isPlaying}。

const r = await fb.player.toggle();
console.log(r.isPlaying ? '正在播放' : '已暂停');

random()

随机播放一曲。返回 {success}。

await fb.player.random();

getState()

获取播放状态。返回 {state, canSeek, canPause}。

const state = await fb.player.getState();
// state.state: 'playing' | 'paused' | 'stopped'

getCurrentTrack()

获取当前播放曲目信息。无正在播放时返回 {success: true, found: false, playing: false}。

返回字段	类型	说明
title	string	曲目标题
artist	string	艺术家
album	string	专辑
albumArtist	string	专辑艺术家
genre	string	流派
date	string	日期
trackNumber	number	曲目序号
discNumber	number	光盘序号
duration	number	时长（秒）
path	string	foobar 原始路径
absolutePath	string	规范化本地文件路径（不含 subsong 后缀）
fullPath	string	完整路径（含 subsong 后缀，如 file.cue//1）
id	string	唯一标识符（path + subsong 组合）
subsong	number	子曲目索引（0 = 普通文件）
fileSize	number	文件大小（字节）
bitrate	number	比特率 (kbps)
sampleRate	number	采样率 (Hz)
channels	number	声道数
codec	string	编码格式

artist / albumArtist / genre / composer（仅指该 API 实际返回的字段）的多值标签按 , 原序拼接，不去重。

const track = await fb.player.getCurrentTrack();
if (track.found !== false) {
    console.log(`${track.artist} - ${track.title} [${track.codec} ${track.bitrate}kbps]`);
}

getPosition()

获取当前播放位置。返回 {position, duration, subsong, path}。

const pos = await fb.player.getPosition();
console.log(`${pos.position} / ${pos.duration}`);
// pos.subsong — 子曲目索引
// pos.path — 当前播放文件路径

getOrder() / setOrder(order)

获取/设置播放顺序。

值	名称
0	Default
1	Repeat (playlist)
2	Repeat (track)
3	Random
4	Shuffle (tracks)
5	Shuffle (albums)
6	Shuffle (directories)

const r = await fb.player.getOrder();
console.log(r.order, r.name); // 0, 'Default'
await fb.player.setOrder(2);  // 单曲循环

getStopAfterCurrent() / setStopAfterCurrent(enabled)

获取/设置“当前曲目后停止”状态。

const r = await fb.player.getStopAfterCurrent();
console.log(r.enabled); // false
await fb.player.setStopAfterCurrent(true);

getCurrentTrackIndex(includeTrackInfo?)

获取当前播放曲目在播放列表中的索引，返回 { index, track? }；传入 true 可请求可选的 track 快照。

const r = await fb.player.getCurrentTrackIndex();
console.log(`播放列表 ${r.playlist}，曲目 ${r.index}`);

playPath(path)

直接播放指定路径的文件。CUE 条目可使用宿主的 subsong 后缀格式。

await fb.player.playPath('E:\\Music\\song.flac');

playPaths(paths, options?)

添加并播放多个文件路径。第二个参数可以是数字 startIndex，也可以是 { startIndex?, replace? }；replace: true 会在插入前清空当前播放列表，默认行为则为追加。

参数	类型	说明
paths	string[]	绝对路径数组；条目可带有 |subsong:N 后缀
options	number | { startIndex?: number; replace?: boolean }	起始偏移量或扩展选项

await fb.player.playPaths(paths, { startIndex: 2, replace: true });

volumeUp() / volumeDown()

音量增大/减小一档。

await fb.player.volumeUp();
await fb.player.volumeDown();

其余方法

getPlayingPlaylist()

封装 playback.getPlayingPlaylist。参数与返回类型以 foo-webview-sdk 的 TypeScript 声明为准（IDE 悬浮提示或包内 bridge.d.ts），行为契约见 API 文档对应条目。

await fb.player.getPlayingPlaylist(/* 参数见 TypeScript 声明 */);

playPause()

封装 playback.playPause。参数与返回类型以 foo-webview-sdk 的 TypeScript 声明为准（IDE 悬浮提示或包内 bridge.d.ts），行为契约见 API 文档对应条目。

await fb.player.playPause(/* 参数见 TypeScript 声明 */);

toggleMute()

封装 playback.toggleMute。参数与返回类型以 foo-webview-sdk 的 TypeScript 声明为准（IDE 悬浮提示或包内 bridge.d.ts），行为契约见 API 文档对应条目。

await fb.player.toggleMute(/* 参数见 TypeScript 声明 */);

toggleStopAfterCurrent()

封装 playback.toggleStopAfterCurrent。参数与返回类型以 foo-webview-sdk 的 TypeScript 声明为准（IDE 悬浮提示或包内 bridge.d.ts），行为契约见 API 文档对应条目。

await fb.player.toggleStopAfterCurrent(/* 参数见 TypeScript 声明 */);