点量BT代码使用说明文档.docx

点量BT代码使用说明文档.docx

《点量BT代码使用说明文档.docx》由会员分享，可在线阅读，更多相关《点量BT代码使用说明文档.docx（60页珍藏版）》请在冰豆网上搜索。

点量BT代码使用说明文档

点量BT代码使用说明文档

Ver3.6.5（build20120614）

版权说明:

如果您是个人作为非商业目的使用，您可以完全自由、免费的使用点量BT内核库和演示程序以及本文档的内容，也期待收到您反馈的意见和建议。

如果您是作为商业使用，那么您需要联系作者申请产品的商业授权。

点量BT库所有演示程序的代码对外公开，内核库的代码只限付费用户个人使用。

Author:

点量软件有限公司

ModifyDate:

2012-06-14

Mail:

support@

HomePage：

一、

点量BT库简介

1.1目的和功能

点量BT源代码的开发目的是让用户无需关心和了解Bittorrent协议的具体实现细节，只需要写几十行甚至几行代码，便可以实现一个功能完善而且强大的BT应用软件，减少越来越多的应用程序需要纳入BT功能时的大量重复性开发和资金成本消耗。

点量BT库提供标准的BT功能支持，同时支持目前流行的各类Bittorrent扩展协议，是一个功能丰富的Bittorrent应用开发工具包。

除了BT功能，点量BT代码还支持客户自定义协议，在基于BT架构的基础上，帮助您实现自己的P2P网络通讯协议，构建自己的P2P用户群。

点量BT库是目前资源占用最少、下载速度最快、速度最稳定的内核，您可以通过试用它来更多地了解点量BT代码，用它来快速实现您的P2P战略。

这里先列举点量BT库的一些基本功能：

●标准BT协议支持：

完全标准官方BT协议的支持，并支持常用的多项扩展协议，点量BT模块完全兼容各类BT应用软件。

并且在现有的所有内核中，点量BT源代码的兼容性是最好的，您可以使用点量BT代码示例程序下载一个流行的种子文件，速度是目前内核中最好的。

这主要是由于点量BT库完全支持DHT和Peer交换等各项扩展协议，以及对BT协议做了很多优化。

●极其方便的调用方式：

采用标准DLL方式，调用方式完全类似于系统API（CreateFile等函数），结合作者完善的开发文档和演示代码，开发一个功能完善的Bittorrent应用软件，所需时间之短超出你的想象。

●极低的资源占用：

点量BT库的内存和CPU占用您可以通过测试了解，极低的资源占用以及高效稳定的传输速度，是您选择BT的最佳选择。

点量BT库的CPU、内存、硬盘等资源是目前国内资源占用最低的内核，3.4版本以后，示例程序自动设置了8M的缓存，计算内存占用时可以考虑去除8M的缓存使用。

其实早在点量BT内核的第一个版本，就已经做到了是国内最少资源占用和速度最稳定的的内核,3.4版本的优化使得资源占用有了进一步降低，体现了在BT内核领域我们的不懈追求和专业。

●兼容uTorrent的UDP穿透传输：

点量BT源代码3.6以后版本支持兼容uTorrent等的udp穿透传输，对无法映射的用户可以自动适应进行udp穿透传输。

并且，点量BT源代码3.6版本的udp穿透传输功能，无需任何额外服务器资源，在p2p网络中自动适应穿透，根据网络类型自动判断适应。

（3.6以后版本）

●支持HTTP协议同时下载（P2SP）：

点量P2P源码当前版本支持Http跨协议下载，一方面突破了国内很多网络环境对BT端口和协议的封锁，另一方面解决了无人供种时的下载问题。

将一个Http地址作为P2P系统中的一个节点，实现了在Http服务器和P2P用户之间同时下载。

IIS的稳定性，以及一些使用了CDN的用户，可以用IIS作为上传源。

●可调节不同网络下的性能参数：

比如在千M局域网中，高速硬盘环境下，通过设置该参数，可以实现单对单传输达50M/s以上的速度，多人同时下载时可以达到磁盘或者网络的极限。

默认设置为适合绝大多数普通网络模式的用户配置。

（3.6.3以后版本）

●DHT网络支持：

点量P2P源代码提供标准的DHT网络支持，并自动加入Bitcomet、官方Bittorent等流行客户端的DHT网络，共享整个BT网络内的用户资源，一方面解决了无Tracker状态下的文件下载，另一方面提高了下载速度。

●可选zip压缩传输：

在传输前可对文本型文件可以进行压缩，收到后自动解压，大大减少传输的数据量和节约带宽，适合文件夹中很多文本型文件的情况，比如一些游戏的资源文件。

（3.6.3以后版本）

●支持伪装Http协议：

用于突破一些特殊环境下的封锁。

（目前发现的有巴西、马来西亚等一些网络封锁需要启用该功能）。

该功能可以和不启用的用户自动兼容。

（3.6.3以后版本）

●智能磁盘分配：

支持全面预分配模式，此模式下可以文件下载前预先分配磁盘空间，减少磁盘碎片的产生；同时也支持边下载边分配的方式，用户可以根据需要自己选择。

在NTFS格式的磁盘系统，还支持SPARSE稀缺分配方式。

●支持HTTP和UDPTracker协议，支持多Tracker协议，支持等效Tracker报告。

●高效的UPnP穿透：

无需XPSP2的支持，实现各版本系统下的内网免配置。

●支持PMP方式的内网穿透：

新型的PMP穿透作为UPnP的补充，进一步提升内网穿透的效率。

●支持内网自动发现：

在同一个局域网内有两个以上用户下载时，系统会进行自动寻找，尽量利用上局域网内部带宽，速度得到迅速提升。

●支持兼容Bitcomet的padding_file技术：

制作种子时可以选择是否对齐文件，如果对齐文件后，一个分块不会横跨2个大的文件，文件末尾不足一整块的，由小文件或者padding_file对齐。

这种机制非常适合文件更新的应用，保证了一个种子文件中，一个文件的某些变化，不会影响到其它文件也需要更新。

而传统的BT技术如果做大型文件夹的更新，由于没有padding_file间隔开文件，一个分块可能横跨了两个文件，第一个文件如果长度发生了变化，该文件后面的所有数据的分块hash均会变化，这样，该文件后面的所有文件都可能需要重新下载。

所以，点量P2P源代码的padding_file技术大大减少了文件更新量。

（3.6以后版本）

●实现了专业的文件更新功能：

1）提供Update接口，点量BT下载器的专业更新功能无需对老文件进行任何扫描校验，直接对比新老种子文件的差异，几毫秒内快速启动更新变化过的数据块。

传统的BT软件在有新种子文件替换老种子时，需要先扫描原始文件才能获知需要去下载哪些数据块，如果一个几G的文件夹，扫描一次需要很久，并且扫描期间机器磁盘占用严重。

所以点量BT源代码提供的这个接口，在有大量文件需要频繁更新时极其有效。

（3.5以后版本）。

2）使用最少量局部更新算法，比如一个1G大的文件，只有几十k的数据块发生了改变，那么内核可以自动检索出有效数据，这在大文件的更新中极为重要。

3）3.6版本以后，基于padding_file技术，改进专业更新接口，使得一个文件的变化，不会影响到其它文件，进一步减少需要更新的数据量。

（3.6以后版本）

4）支持临时目录接口，更新文件时，可以将所需下载的分块下载到一个临时目录，下载完成后一次性替换，这样下载过程中原始文件可以正常使用。

该功能可以提供调用示例。

（3.6.3以后版本）

●数据块级别下载优先级指定：

优化数据块下载优先级算法，支持数据块级别的下载优先级设定，使得高优先级的数据块最快下载，更好地支持了音视频点播直播等P2P应用；提升点播直播数据时拖动的响应速度。

●自动防火墙穿透技术：

全自动穿透XP、Vista网络连接防火墙（ICF）和网络连接共享（ICS）。

●支持XPSP2的TCP/IP连接数限制的破解修改，保证P2P的良好效果。

●智能文件续传：

记录上次文件的各种信息，下次启动时无需扫描，立即启动下载。

并且保存了上次的Peer信息，提高启动下载的速度。

●完善丰富的接口支持：

提供丰富的控制和获取信息的接口，满足应用程序绝大部分的功能需求。

比如，不仅可以限制全局上传下载速度和连接数，也可以对每个任务单独设置等。

可获取当前所有连接的详情、整体情况、单个任务情况、每个文件的信息、健康率、分享率等。

●提供专业上传服务器模式：

点量BT库配套有专业上传服务器内核，该内核专注于上传性能的提升，优化大量文件上传时的传输效率和IO性能，适合提供大量文件给客户下载时使用（比如视频网站、游戏程序的分发时，由专门的服务器使用上传服务器模式支撑大量用户的下载）。

●私有种子加密：

通过私有种子加密，可以构建自己的私有BT网络，防止其它客户端使用你公司的种子文件。

●私有协议支持：

支持设置自定义协议，构建自己的私有P2P网络（可防止其它BT软件下载您的文件），并突破各网络环境对BT应用的封锁。

私有模式下去除了BT的痕迹，可以穿透运营商对BT协议的封锁。

●协议加密和数据加密支持：

点量P2P源代码3.0以后的版本支持对协议进行加密，或者对数据进行加密，在不兼容Bitcomet等BT客户端的同时，突破运营商对BT软件的封锁。

同时，数据加密还可用于传输保密数据。

●支持常见的各类代理：

支持用户设置Http、Http1.1、Socks4、Socks5、需要密码的Socks5等代理。

●高兼容性的种子制作功能：

支持UTF-8扩展和多语言，支持嵌入发布者等信息到种子文件。

●支持所有字符的种子文件、支持UTF-8和非UTF-8的标准和非标准种子文件：

点量BT代码已经在几十种字符文件中进行了测试，可以完美支持日韩等东方字符，以及各类特殊字符的文件；同时完美兼容UTF-8和非UTF-8的种子文件。

●支持种子市场、Peer信息交换等扩展协议。

●优秀的磁盘缓存效率：

点量P2P库3.6版本改进的磁盘缓存机制，自动适应多种磁盘缓存算法，提高磁盘缓存命中率，从而提升下载和上传速度，较好地提升内核整体性能。

●支持IPV6：

同时兼容IPV4和IPV6扩展，可以自动适应。

●支持无种子模式下载（magnet磁链）：

可以高效的支持“DLBT:

//4DFFG5667F44DD346A0C944225432452（种子文件的Hash值）/天龙八部（名称）”这种地址直接从网址上自动下载，而不再需要种子文件，种子文件将通过P2P网络传输，减轻服务器提供种子文件的压力---我们同时可提供这类网站和客户端的架设、设计方案。

●提供源代码：

点量BT代码可以在支付一定费用后对用户提供，解除您的后顾之忧，可以完全控制您的BT控件。

●完善的多种语言示例代码：

点量P2P源码开发包目前提供VC（C++/MFC）版本、Delphi版本、C#版本、VB版本的示例程序源代码，易语言、Java、Borland等其它语言的示例程序也可以联系点量软件申请获得，尽可能减少客户的开发量。

●具备跨平台的潜力：

点量BT模块是目前最具有可移植性的BT内核之一，目前提供的示例程序只适用于Windows系统，但如果去除掉突破XPSP2并发连接数限制等少量XP下的特定功能后，点量BTDLL完全可以应用于Linux、WinCE等其它系统下。

如果需要其它平台的支持，需要支付一定的定制费用，或者购买点量BT代码后自己稍作修改，非常容易。

1.2适用范围

如果您需要开发BT或者P2P的下载功能，那么可以考虑使用点量BT源代码，您可以在点量BT代码的基础上开发，希望能对您有所帮助，节省您的开发成本。

如果您需要提供较大数据量的软件、视频等文件供其它人在互联网进行下载，而且您希望节省带宽和服务器成本，并获取更快的速度，那么可以考虑使用点量P2P库，使用点量BT库开发工具包很快就可以实现您想要的上传服务器。

点量P2P内核可以被应用于视频网站、软件站点、网络游戏程序的下载和更新、教育视频和文档的下载、视频点播VOD系统等领域。

1.3点量BT专业上传服务器

点量BT库已经于2009年1月3日，正式发布了专业上传服务器内核。

该