aardio 文档

wsock.tcp.httpStreamMp3 库模块帮助文档

内存 MP3 URL

httpStreamMp3Object 成员列表 #

httpStreamMp3Object.close() #

撤销 URL、唤醒等待中的 HTTP 请求、停止自有服务并释放全部音频。可重复调用。
不会停止播放器已经缓存的声音;应用应另行停止播放器。未手动调用时析构自动清理。

httpStreamMp3Object.error #

来源或容量错误(如有)。

httpStreamMp3Object.finish(err) #

结束输入。省略 err 表示成功:各请求发完剩余数据后正常结束,URL 和音频仍然保留。
传入错误字符串或错误表表示来源失败:当前响应中断,不混入错误文本;后续 GET 返回 503。
成功转换状态返回 true;重复正常 finish 返回 true;已经失败或关闭返回 null,err。
不表示播放器已经播放完。

httpStreamMp3Object.maxBytes #

最大保留字节数;创建时通过 options 指定。

httpStreamMp3Object.size #

当前保留的音频字节数(只读);close 后为 0。

httpStreamMp3Object.state #

状态(只读):open、finished、failed、closed。

httpStreamMp3Object.url #

可立即交给播放器的 MP3 URL(只读)。
无需等到首块音频或 finish。close 后失效。

httpStreamMp3Object.write(data) #

按序追加 MP3 字节;data 是字符串或 buffer。成功返回 true,失败返回 null,err。
空字节串是无操作,不表示 EOF;buffer 会复制。
达到 maxBytes 后拒绝超限整块并将流标为 failed。不等待播放器读取。

wsock.tcp 成员列表 #

wsock.tcp.httpStreamMp3 #

本机内存 MP3 HTTP 流。一个对象对应一个 URL;不依赖 TTS 引擎、播放器或音频文件。

wsock.tcp.httpStreamMp3() #

返回对象:httpStreamMp3Object

wsock.tcp.httpStreamMp3(options) #

创建并启动仅监听 127.0.0.1 的独立 HTTP 服务,成功返回对象,失败返回 null,err。
options 可省略:port=0 自动分配端口;threadNum=1;maxBytes=33554432(32 MiB)。
在创建线程中调用对象方法。音频全部保留到 close;不做环形回收、自动过期、重试或 Range seek。

Markdown 格式