# wsock.bt.metadataClient 库模块帮助文档

## wsock.bt 成员列表 <a id="wsock.bt" href="#wsock.bt">&#x23;</a>

### wsock.bt.metadataClient <a id="wsock.bt.metadataClient" href="#wsock.bt.metadataClient">&#x23;</a>
BitTorrent 协议 torrent 文件元数据下载客户端。  

此客户端可用于访问 process.aria2 对象的 BT 服务端口（listeningPort 属性）。

### wsock.bt.metadataClient() <a id="wsock.bt.metadataClient" href="#wsock.bt.metadataClient">&#x23;</a>
[返回对象:wsockBtMetadataClientObject](#wsockBtMetadataClientObject)

### wsock.bt.metadataClient(.infoHash,peerId) <a id="wsock.bt.metadataClient" href="#wsock.bt.metadataClient">&#x23;</a>
创建元数据下载客户端。  

参数 @infoHash 指定 torrent 文件 info 字段的哈希值。  
这里指的是原始哈希值，而不是 16 进制编码后的哈希文本。  

参数 @peerId 指定当前客户端 peer ID，不指定则随机生成（建议不要用随机值）。

## wsockBtMetadataClientObject 成员列表 <a id="wsockBtMetadataClientObject" href="#wsockBtMetadataClientObject">&#x23;</a>

### wsockBtMetadataClientObject.getMetadata <a id="wsockBtMetadataClientObject.getMetadata" href="#wsockBtMetadataClientObject.getMetadata">&#x23;</a>
获取 torrent 文件元数据

### wsockBtMetadataClientObject.getMetadata(ip,port,timeout) <a id="wsockBtMetadataClientObject.getMetadata" href="#wsockBtMetadataClientObject.getMetadata">&#x23;</a>
参数 @ip,@port 指定目标 peer 的 IP 与端口。  

参数 @timeout 指定超时，可选参数，默认值为 5 秒。  

成功返回元数据（buffer对象）。  
可调用 bencode.decode 函数进行解码。
