智能小程序 Ray 开发媒体 API —— 音频 API 合集（二）

getAudioFileDuration

获取音频文件时长信息

引入

import { getAudioFileDuration } from '@ray-js/ray';

需引入BaseKit，且在>=2.4.3版本才可使用。

参数

Object object

属性	类型	默认值	必填	说明
path	string		是	音频文件路径，不支持线上地址
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

object.success 回调参数

参数

Object res

属性	类型	说明
duration	number	音频时长

object.fail 回调参数

参数

Object res

属性	类型	说明
errorMsg	string	插件错误信息
errorCode	string	错误码
innerError	object	插件外部依赖错误信息 {errorMsg: string, errorCode: string }

👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。

getCurrentVolume

获取当前系统音量

引入

import { getCurrentVolume } from '@ray-js/ray';

需引入BaseKit，且在>=2.4.3版本才可使用

参数

Object object

属性	类型	默认值	必填	说明
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

object.success 回调参数

参数

Object res

属性	类型	说明
value	number	音量，阈值【0 - 1】

object.fail 回调参数

参数

Object res

属性	类型	说明
errorMsg	string	插件错误信息
errorCode	string	错误码
innerError	object	插件外部依赖错误信息 {errorMsg: string, errorCode: string }

getCurrentVolumeByMode

获取不同模式的系统音量

引入

import { getCurrentVolumeByMode } from '@ray-js/ray';

需引入BaseKit，且在>=3.3.3 @ray-js/ray >= 0.9.0版本才可使用

参数

Object object

属性	类型	默认值	必填	说明
volumeMode	number		否	音量类型（仅 Android 生效）： - 0：语音电话的声音 - 2：响铃，通知，系统默认音等 - 3：手机音乐的声音 - 4：手机闹铃的声音 - 6：蓝牙音量
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

object.success 回调参数

参数

Object res

属性	类型	说明
value	number	音量，阈值【0 - 1】
volumeMode	number	音量类型（仅 Android 生效）： - 0：语音电话的声音 - 2：响铃，通知，系统默认音等 - 3：手机音乐的声音 - 4：手机闹铃的声音 - 6：蓝牙音量

object.fail 回调参数

参数

Object res

属性	类型	说明
errorMsg	string	插件错误信息
errorCode	string	错误码
innerError	object	插件外部依赖错误信息 {errorMsg: string, errorCode: string }

函数定义示例

/**
 * 获取不同模式的系统音量
 */
export function getCurrentVolumeByMode(params?: {
  /**
   * 音量类型（仅Android生效）
   * 0：语音电话的声音
   * 2：响铃，通知，系统默认音等
   * 3：手机音乐的声音
   * 4：手机闹铃的声音
   * 6：蓝牙音量
   */
  volumeMode?: number;
  /** 接口调用结束的回调函数（调用成功、失败都会执行） */
  complete?: () => void;
  /** 接口调用成功的回调函数 */
  success?: (params: {
    /** 音量，阈值【0 - 1】 */
    value: number;
    /**
     * 音量类型（仅Android生效）
     * 0：语音电话的声音
     * 2：响铃，通知，系统默认音等
     * 3：手机音乐的声音
     * 4：手机闹铃的声音
     * 6：蓝牙音量
     */
    volumeMode: number;
  }) => void;
  /** 接口调用失败的回调函数 */
  fail?: (params: {
    errorMsg: string;
    errorCode: string | number;
    innerError: {
      errorCode: string | number;
      errorMsg: string;
    };
  }) => void;
}): void;

👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。