musicNotify

来自于:小沈阳的弟弟

概述

musicNotify是一个类似酷狗音乐播放的通知栏模块,开发者可自定义歌曲,歌手以及LOGO图标的名称,支持监听上一曲,上一曲,暂停,关闭等事件。注:使用本模块前请先使用官方提供方法检测通知栏权限;本模块不提供播放功能,可以配合官方提供的其他音乐播放器模块一起使用。

open

打开

open({params}, callback(ret, err))

params

musicName:

  • 类型:字符串
  • 描述:(可选项)音乐的名称,例如:光辉岁月

singerName:

  • 类型:字符串
  • 描述:(可选项)歌手的名称,例如:BEYOND

file:

  • 类型:数字
  • 默认值:无
  • 描述:(可选项)通知栏显示的logo图片,要求网络路径(http://、https://)

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    state:            //数字类型;对应的值有:success,closeClick,pauseOrPlayClick,preClick,nextClick;

}
    success表示打开成功,closeClick为用户点击了关闭按钮,pauseOrPlayClick为用户点击了开始/暂停按钮,preClick为用户点击了上一曲按钮,nextClick为用户点击了下一曲按钮

示例代码

var musicNotify = api.require('musicNotify');
musicNotify.open({
    musicName: "不再犹豫",
    singerName: "BEYOND乐队",
    file:"http://cdn.zxwindow.com/toutiaoforum/202105/08/60962f7e0f8ed.jpg"
}, function(ret, err) {
    if (ret) {
        //alert(JSON.stringify(ret));
        if(ret.state=="success")
        {
            alert("打开成功");
        }
        else if(ret.state=="closeClick")
        {
            alert("用户点击了关闭按钮");
        }
        else if(ret.state=="pauseOrPlayClick")
        {
            alert("用户点击了关闭按钮");
        }
        else if(ret.state=="preClick")
        {
            alert("用户点击了上一曲按钮");
        }
        else if(ret.state=="nextClick")
        {
            alert("用户点击了下一曲按钮");
        }
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

Android系统

可提供的1.0.0及更高版本

updateInfo

更新通知栏视图中的歌手,歌曲,logo图信息

updateInfo({params})

params

musicName:

  • 类型:字符串
  • 描述:(可选项)音乐的名称,例如:光辉岁月

singerName:

  • 类型:字符串
  • 描述:(可选项)歌手的名称,例如:BEYOND

file:

  • 类型:数字
  • 默认值:无
  • 描述:(可选项)通知栏显示的logo图片,要求网络路径(http://、https://)

示例代码

var musicNotify = api.require('musicNotify');
musicNotify.updateInfo({
    musicName: "不再犹豫",
    singerName: "BEYOND乐队",
    file:"http://cdn.zxwindow.com/toutiaoforum/202105/08/60962f7e0f8ed.jpg"
});

可用性

Android系统

可提供的1.0.0及更高版本

setPlay

设置远程视图为播放按钮(隐藏暂停按钮)

setPlay();

示例代码

var musicNotify = api.require('musicNotify');
musicNotify.setPlay();

可用性

Android系统

可提供的1.0.0及更高版本

setPause

设置远程视图为暂停按钮(隐藏播放按钮)

setPause();

示例代码

var musicNotify = api.require('musicNotify');
musicNotify.setPause();

可用性

Android系统

可提供的1.0.0及更高版本

close

关闭远程视图

close()

示例代码

var musicNotify = api.require('musicNotify');
musicNotify.close();

可用性

Android系统

可提供的1.0.0及更高版本