# bass.channel 库模块帮助文档 ## bass 成员列表 # ### bass.channel() # [返回对象:basschannelObject](#basschannelObject) ## bass.channel 成员列表 # ### bass.channel.create # 创建 PCM 样本推送流（不能推送 MP3 编码字节）。成功返回 bass.channel 对象, 失败返回 null,错误信息 ### bass.channel.create() # [返回对象:basschannelObject](#basschannelObject) ### bass.channel.create(freq,chans,flags) # 创建音频推送流。参数@freq 指定采样率，@chans 指定通道数，@flags 指定选项。可选使用参数@2指定选项详细用法请参考bass文档 ### bass.channel.open # 打开音频。成功返回 bass.channe 对象, 失败返回 null,错误信息 ### bass.channel.open() # [返回对象:basschannelObject](#basschannelObject) ### bass.channel.open(buffer,flags) # 打开音频, 参数 @1 需要用一个 buffer 对象指定内存数据。可选使用参数 @2 指定选项。详细用法请参考 bass 文档 ### bass.channel.open(path,flags) # 打开音频, 参数 @1 可用一个字符串指定本地文件路径、资源文件路径、网址、内存数据, 可选使用参数 @2 指定选项详细用法请参考 bass 文档。 ### bass.channel.openPush() # [返回对象:basschannelObject](#basschannelObject) ### bass.channel.openPush(initialData,flags) # 创建压缩文件推送流（MP3/OGG 等，非 PCM）。参数 @initialData 是从文件开头连续取得的初始数据；不足以识别格式时可能失败，可积累更多初始数据后重试。成功返回 channel,已消费的初始字节数；未消费的初始字节仍须先 pushFile，再推送后续字节。失败返回 null,错误信息,BASS错误码。禁止 AUTOFREE。必须在创建线程调用 free。通常请改用自动缓冲与收尾的 bass.streamPlayer。 ## basschannelObject 成员列表 # ### basschannelObject.duration() # 返回总时长,以秒为单位 ### basschannelObject.effect() # [返回对象:basseffectObject](#basseffectObject) ### basschannelObject.effect(type,priority) # 创建效果 ### basschannelObject.free() # 释放对象音频对象不会自动释放, 必须在不再使用该音频时手动调用些函数释放对象 ### basschannelObject.getAttribute(attrib) # 获取属性值 ### basschannelObject.getData(_BASS_DATA) # 获取FFT频谱数据 ### basschannelObject.getDevice() # 返回音频设备索引 ### basschannelObject.getInfo() # 返回音频信息,返回格式请参考些函数源码 ### basschannelObject.getPosition() # 返回当前位置,可选使用参数@1指定使用的单位 ### basschannelObject.getTime() # 返回以秒为单位的当前播放时间位置 ### basschannelObject.getVolume() # 返回音量, 返回值为0到1之间表示百分比的小数 ### basschannelObject.isActive() # 音频是否可用 ### basschannelObject.loop() # 设置是否循环播放 ### basschannelObject.pause() # 暂停播放 ### basschannelObject.play() # 播放音频 ### basschannelObject.posCallback(callback,interval) # ```aardio basschannelObject.posCallback( function(seconds){ /*播放进度改变时触发此函数, seconds为当前播放时长,以秒为单位*/ } ) ``` ### basschannelObject.push # 向 bass.channel.create 创建的流推送 PCM 样本，不能传入 MP3 编码字节 ### basschannelObject.push(buffer,length) # buffer 为字符串或 buffer 对象。 length 指定推送长度，如果不指定 length 则自动取参数 @1 长度。如果参数 @1 为内存指针，则必须指定 length 参数 ### basschannelObject.pushFile(data,length) # 向 openPush 创建的压缩文件流添加编码字节。返回实际接收字节数（0 表示缓冲暂满），失败返回 null,错误信息；必须保留未接收的数据并稍后重试，不能丢弃。参数 length 默认 #data；pushFile(null,0) 表示 EOF，仅可在全部数据已接收后调用。空块不能当作普通数据调用此接口。建议直接使用 bass.streamPlayer 自动处理缓冲与 EOF。 ### basschannelObject.resetEffect() # 重置效果 ### basschannelObject.setAttribute(attrib,value) # 设置属性值 ### basschannelObject.setDevice() # 指定音频设备索引, 参数为 bass.getDeviceInfos 返回的音频设备数组中对应设备的数组索引值, 参数指定的设备索引如果未初始化则自动调用 bass.init 函数初始化 ### basschannelObject.setFlags(flags,mask) # 设置选项 ### basschannelObject.setPosition(pos) # 设置位置,可选使用参数@2指定使用的单位 ### basschannelObject.setSpeed(速率) # 设置播放速度。参数为 0 到 1 的小数减慢速度，设为大于 1 的数加快速度，1 为正常速度。此函数调用 setAttribute 函数并以 _BASS_ATTRIB_FREQ 为参数改变采样率，从而影响播放速度。此方法对音高也有影响，播放速度更快声音也会变得更尖锐， ### basschannelObject.setTime(seconds) # 设置当前播放时间位置,参数指定秒数 ### basschannelObject.setVolume() # 使用0到1之间表示百分比的小数设置音量 ### basschannelObject.slideAttribute(attrib,value,milliseconds) # 在参数@3指定的时间内渐变参数@1指定的属性到参数@2指定的值 ### basschannelObject.slideVolume(vol,milliseconds) # 渐变音量到 @vol 参数指定的值, 使用 0 到 1 之间表示百分比的小数表示音量 ,参数@3指定渐变时长 ### basschannelObject.stop() # 停止播放 ### basschannelObject.syncCallback(callback,syncType,syncParam) # ```aardio basschannelObject.syncCallback(function(data){ },_BASS_SYNC/*指定同步回调类型,可选用参数@3指定附加参数此函数详细用法请参数函数源码以及bass.dll的文档*/) ``` ## basseffectObject 成员列表 # ### basseffectObject.delete() # 删除效果 ### basseffectObject.getParameters() # 获取参数 ### basseffectObject.setParameters() # 设置参数 ### basseffectObject.setPriority() # 设置优先级