wsock.tcp.httpStreamMp3：内存 MP3 URL

把陆续到达的 MP3 字节提供为普通 HTTP URL。一个对象对应一条音频和一个独立的本机 HTTP 服务。

不依赖 TTS 引擎或播放器，不创建、读取或写入音频文件。
边 write 边发送，无需等到完整音频生成。
音频分块保留到 close；没有环形回收、自动过期、重试或多会话管理器。
直接复用 wsock.tcp.simpleHttpServer；成功写入后发送下一块，发送失败便退出该请求。

最小接口

import wsock.tcp.httpStreamMp3;

var stream,err=wsock.tcp.httpStreamMp3();
if(!stream) return null,err;

// 创建后即可把 stream.url 交给播放器，不必等待首块音频。
// 收到编码音频时多次调用：
// stream.write(mp3Bytes);

// 输入成功结束。HTTP 发完剩余数据才结束，URL 与数据继续保留。
// stream.finish();

// 若来源失败，用 stream.finish(err)，不要伪装成成功 EOF。
// 不再使用时调用 stream.close()；一个对象只用于一次输入过程。

可直接运行的窗体示例：~/examples/Media/Audio/edgeTTS-http.aardio。示例使用普通 WMPlayer.OCX 打开 URL；替换播放器时只替换打开/停止地址的代码。

服务端边发送不等于所有播放器都会立即起播。 本机验证中，web.form 的 IE <audio> 可以在输入完成前开始播放；WMPlayer.OCX 能播放同一 URL，但会等 HTTP 响应结束后再播放。示例用于演示地址交接；若强调低延迟，应选用支持该 MP3 URL 渐进播放的客户端。

接入 TTS

在已有消息循环的窗体程序中，把 HTTP 流直接作为引擎的输出对象即可：合成成功调用 stream.finish()，失败调用 stream.finish(错误信息)，取消不会调用它。

import web.edgeTextToSpeech;
import wsock.tcp.httpStreamMp3;

var stream,err=wsock.tcp.httpStreamMp3();
if(!stream) return null,err;
var engine=web.edgeTextToSpeech();
var task,err=engine.synthesize({text="你好，这是内存音频流。"},stream); // 音频直接写入 URL
if(!task){stream.close();return null,err;}

// 把 stream.url 交给现有播放器。窗体关闭时：
// 1. 停止播放器；2. task.cancel()；3. stream.close()。
// 合成结束只会 finish，不会 close：客户端可能还要读取音频。

这里接收的是 MP3 编码字节，不是 PCM，不要求每个字节块都是完整 MP3 文件。HTTP 服务不转码，也不保证独立音频文件拼接后的无缝播放。

生命周期

操作/属性	含义
`url`	创建成功即可使用的地址，只监听 `127.0.0.1`；路径随机，每个实例独立
`write(data)`	接受字符串或 buffer，按原始字节追加；成功返回 true，失败返回 null,err。buffer 会复制，空字节串是无操作
`finish()`	封口；已有请求发完数据后正常结束。重复正常 finish 返回 true
`finish(err)`	标记来源失败；正在发送的响应中断，不混入错误文本；新请求返回 503
`close()`	释放全部保留音频、唤醒等待中的请求并停止自有服务；可重复调用
`state`	`open`、`finished`、`failed`、`closed`，只读状态
`size`	保留的编码字节数；close 后为 0
`error`	来源或容量错误（如有）

对象方法在创建线程中调用；TTS 回调可直接写入，HTTP 读取在独立工作线程中执行。保留对象到使用结束，不要在创建它的短线程退出后继续依赖 URL。

读到目前末尾但输入尚未完成时，HTTP 请求等待新数据。每个请求有自己的块索引，读取不会消耗共享音频。

finish 不是播放结束，close 也不能撤回播放器已经缓存的声音。停止声音仍需调用播放器自己的停止接口。

可选设置

import wsock.tcp.httpStreamMp3;
var stream,err=wsock.tcp.httpStreamMp3({
    port=0;             // 系统自动分配本机端口
    threadNum=1;        // HTTP 请求工作线程数，不是语音路数
    maxBytes=33554432;  // 单次输入最多保留 32 MiB 压缩音频
});
if(stream) stream.close();

默认值已适合桌面单路 TTS。达到容量上限时，拒绝整个超限字节块、返回错误并封口，不覆盖历史数据、不等待已读数据腾空间，也不自动写入硬盘。明确不需要该音频时调用 close 即可释放全部内存。

HTTP 范围

支持 GET、HEAD；HEAD 不消耗音频。
输入尚未完成时，HTTP/1.1 使用 chunked，HTTP/1.0 使用连接关闭定界。
输入成功完成后，新请求返回固定长度的完整内容。
不实现 Range/seek/断点续传：忽略 Range，始终从头返回完整 200，发送 Accept-Ranges: none。
发送 Cache-Control: no-store；只保证此库没有音频落盘逻辑，不承诺第三方播放器或操作系统内部完全不写盘。

这是有限音频的简易本地 URL，不是长期广播、多租户或可拖动进度的媒体服务器。

Markdown 格式