BackgroundAudioManager

解释：swan.getBackgroundAudioManager 的返回值。

方法参数

backgroundAudioManager 类的属性列表

属性类型只读说明最低版本

startTime

Number

否

开始播放的位置（单位：s），默认 0

duration

Number

是

当前音频的长度（单位：s），只有在当前有合法的 src 时返回

currentTime

Number

是

当前音频的播放位置（单位：s），只有在当前有合法的 src 时返回，时间不取整，保留小数点后 6 位

paused

Boolean

是

当前是否暂停或停止状态。true：表示暂停或停止，false：表示正在播放

title

String

否

音频标题，用于做原生音频播放器音频标题。原生音频播放器中的分享功能，分享出去的卡片标题，也将使用该值

epname

String

否

专辑名，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值

singer

String

否

歌手名，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值

coverImgUrl

String

否

封面图 url，用于做原生音频播放器背景图。原生音频播放器中的分享功能，分享出去的卡片配图及背景也将使用该图

src

String

否

音频的数据链接，用于直接播放，请在上述属性设置完成后使用该属性。有效值：m4a、aac、mp3、wav

lrcURL

String

否

歌词 url ，用于做原生音频播放器展示的歌词

最低支持版本 3.170.2

showFloatView

Boolean

否

是否在小程序内显示背景音乐悬浮球

最低支持版本 3.220.5

floatPosition

Number

否

背景音乐悬浮球初始位置，以设备屏幕左侧 1/3 线以下为基准，按照所设置的比例进行悬浮球初始化位置的设定，可选区间为 [0, 1]

最低支持版本 3.220.5

示例

跳转编辑工具

在开发者工具中打开

在 WEB IDE 中打开

扫码体验

代码示例

百度智能小程序

请使用百度APP扫码

图片示例

BackgroundAudioManager - 图2

代码示例

  • JS
  2. Page({
  3.     onLoad() {
  4.         const backgroundAudioManager = swan.getBackgroundAudioManager();
  5.         console.log('backgroundAudioManager:', backgroundAudioManager)
  6.         backgroundAudioManager.title = '演员';
  7.         backgroundAudioManager.epname = '演员';
  8.         backgroundAudioManager.singer = '薛之谦';
  9.         backgroundAudioManager.coverImgUrl = 'https://c.hiphotos.baidu.com/super/pic/item/8b13632762d0f703e34c0f6304fa513d2797c597.jpg';
  10.         // 歌词地址，基础库 3.170.2 开始支持，以下仅为示例，非真实接口地址
  11.         backgroundAudioManager.lrcURL = 'xxxxx';
  12.         // 在小程序内显示背景引用悬浮球，基础库 3.220.5 开始支持
  13.         backgroundAudioManager.showFloatView = true;
  14.         // 设置悬浮球初始位置
  15.         backgroundAudioManager.floatPosition = 0.5;
  17.         backgroundAudioManager.onPlay(res => {
  18.             swan.showToast({
  19.                 title: 'play',
  20.                 icon: 'none'
  21.             });
  22.             console.log('onPlay', res);
  23.         });
  25.         backgroundAudioManager.onPause(res => {
  26.             swan.showToast({
  27.                 title: 'pause',
  28.                 icon: 'none'
  29.             });
  30.             console.log('onPause', res);
  31.         });
  33.         backgroundAudioManager.onStop(res => {
  34.             swan.showToast({
  35.                 title: 'stop',
  36.                 icon: 'none'
  37.             });
  38.             console.log('onStop', res);
  39.         });
  41.         backgroundAudioManager.onEnded(res => {
  42.             swan.showToast({
  43.                 title: 'end',
  44.                 icon: 'none'
  45.             });
  46.             console.log('onEnded', res);
  47.         });
  49.         backgroundAudioManager.onTimeUpdate(res => {
  50.             console.log('onTimeUpdate', res);
  51.         });
  53.         backgroundAudioManager.onError(res => {
  54.             swan.showToast({
  55.                 title: 'error',
  56.                 icon: 'none'
  57.             });
  58.             console.log('onError', res);
  59.         });
  61.         backgroundAudioManager.onWaiting(res => {
  62.             swan.showToast({
  63.                 title: 'waiting',
  64.                 icon: 'none'
  65.             });
  66.             console.log('onWaiting', res);
  67.         });
  69.         backgroundAudioManager.onSeeked(res => {
  70.             swan.showToast({
  71.                 title: 'onSeeked',
  72.                 icon: 'none'
  73.             });
  74.             console.log('onSeeked', res);
  75.         });
  76.         backgroundAudioManager.onSeeking(res => {
  77.             swan.showToast({
  78.                 title: 'onSeeking',
  79.                 icon: 'none'
  80.             });
  81.             console.log('onSeeking', res);
  82.         });
  84.         backgroundAudioManager.onNext(res => {
  85.             swan.showToast({
  86.                 title: 'onNext',
  87.                 icon: 'none'
  88.             });
  89.             console.log('onNext', res);
  90.         });
  92.         backgroundAudioManager.onPrev(res => {
  93.             swan.showToast({
  94.                 title: 'onPrev',
  95.                 icon: 'none'
  96.             });
  97.             console.log('onPrev', res);
  98.         });
  99.         this.backgroundAudioManager = backgroundAudioManager;
  100.     },
  101.     play() {
  102.         this.backgroundAudioManager.src = 'https://vd3.bdstatic.com/mda-ic7mxzt5cvz6f4y5/mda-ic7mxzt5cvz6f4y5.mp3';
  103.         this.backgroundAudioManager.play();
  104.     },
  105.     pause() {
  106.         this.backgroundAudioManager.pause();
  107.     },
  108.     stop() {
  109.         this.backgroundAudioManager.stop();
  110.     },
  111.     seek() {
  112.         this.backgroundAudioManager.seek(10);
  113.     }
  114. });