更新记录

1.0.7（2024-10-31）

修复addEventListener事件不能多次触发问题

1.0.6（2024-09-10）

修改本地文件参数规则，去掉内部路径转换逻辑。

1.0.5（2024-09-07）

安卓端新增更新播放器UI接口。

平台兼容性

概述

XF-notifiViewUTS封装了在Android和iOS中实现通知栏音乐播放器控制栏效果。

插件接口

addEventListener

监听通知栏播放器UI事件

uni-app项目中（nvue）调用示例：

import { addEventListener } from "@/uni_modules/XF-notifiViewUTS"

addEventListener({
  complete: (res) => {
    console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { addEventListener } from "@/uni_modules/XF-notifiViewUTS";
import { EventListenerOptions } from "@/uni_modules/XF-notifiViewUTS/utssdk/interface.uts";

let options = {
  complete: (res : any) => {
    console.log(res)
  }
} as EventListenerOptions;
addEventListener(options);

可用性

iOS、Android系统

可提供的1.0.0及更高版本

sendNotification

显示通知栏播放器UI

uni-app项目中（nvue）调用示例：

import { sendNotification } from "@/uni_modules/XF-notifiViewUTS"

sendNotification({
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { sendNotification } from "@/uni_modules/XF-notifiViewUTS";
import { NotificationOptions } from "@/uni_modules/XF-notifiViewUTS/utssdk/interface.uts";

let options = {
    backgroundColor: '#FF3E96',
    songName: '我是歌曲' + new Date().getTime() + new Date().getTime() + new Date().getTime(),
    songNameStyle: {
        smallColor: '#FFE4C4',
        smallSize: 12,
        bigColor: '#FFE4C4',
        bigSize: 16,
    } as StyleOptions,
    //songSinger: '我是演唱者' + new Date().getTime() + new Date().getTime() + new Date().getTime(),
    songSingerStyle: {
        smallColor: '#FFE4C4',
        smallSize: 8,
        bigColor: '#FFE4C4',
        bigSize: 10,
    } as StyleOptions,
    songAlbum: 'https://mp-ebdfa47d-d79c-4b44-8224-3febec037f05.cdn.bspapp.com/uimusic_play_cover_pic_bg.png',
    isPlay: true,
  complete: (res : any) => {
    console.log(res)
  }
} as NotificationOptions;
sendNotification(options);

可用性

iOS、Android系统

可提供的1.0.0及更高版本

cleanNotification

关闭通知栏播放器UI

uni-app项目中（nvue）调用示例：

import { cleanNotification } from "@/uni_modules/XF-notifiViewUTS"

cleanNotification();

uni-app x项目（uvue）中调用示例：

import { cleanNotification } from "@/uni_modules/XF-notifiViewUTS";

cleanNotification();

可用性

Android系统

可提供的1.0.0及更高版本

setPlaybackTime

设置播放进度信息

uni-app项目中（nvue）调用示例：

import { setPlaybackTime } from "@/uni_modules/XF-notifiViewUTS"

setPlaybackTime({
  duration : 1120,
  position : 20,
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { setPlaybackTime } from "@/uni_modules/XF-notifiViewUTS";
import { TimeOptions } from "@/uni_modules/XF-notifiViewUTS/utssdk/interface.uts";

let options = {
  duration : 1120,
  position : 20,
  complete: (res : any) => {
    console.log(res)
  }
} as TimeOptions;
setPlaybackTime(options);

可用性

iOS系统

可提供的1.0.0及更高版本

updateNotification

更新通知栏播放器UI

uni-app项目中（nvue）调用示例：

import { updateNotification } from "@/uni_modules/XF-notifiViewUTS"

updateNotification({
  isPlay: true,
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { updateNotification } from "@/uni_modules/XF-notifiViewUTS";
import { UpdateNotificationOptions } from "@/uni_modules/XF-notifiViewUTS/utssdk/interface.uts";

let options = {
  isPlay: true,
  complete: (res : any) => {
    console.log(res)
  }
} as UpdateNotificationOptions;
updateNotification(options);

可用性

Android系统

可提供的1.0.0及更高版本