KCP 开源项目教程
项目介绍
KCP 是一个快速可靠的 ARQ(自动重传请求)协议,旨在通过牺牲 10%-20% 的带宽来换取平均延迟降低 30%-40% 和最大延迟降低三倍的传输效果。KCP 纯算法实现,不负责底层协议(如 UDP)的收发,需要使用者自己定义下层数据包的发送方式,并以回调的方式提供给 KCP。KCP 协议只有 ikcp.h
和 ikcp.c
两个源文件,可以方便地集成到用户自己的协议栈中。
项目快速启动
安装 KCP
您可以使用 vcpkg 库管理器下载并安装 KCP:
git clone https://github.com/Microsoft/vcpkg
cd vcpkg
./bootstrap-vcpkg.sh
./vcpkg integrate install
./vcpkg install kcp
基本使用
- 创建 KCP 对象:
// 初始化 kcp 对象,conv 为一个表示会话编号的整数,和 TCP 的 conv 一样,通信双方需保证 conv 相同
ikcpcb *kcp = ikcp_create(conv, user);
- 设置回调函数:
// KCP 的下层协议输出函数,KCP 需要发送数据时会调用它
int udp_output(const char *buf, int len, ikcpcb *kcp, void *user) {
// 实现数据发送逻辑
}
// 设置回调函数
kcp->output = udp_output;
- 循环调用 update:
// 以一定频率调用 ikcp_update 来更新 kcp 状态,并且传入当前时钟(毫秒单位)
ikcp_update(kcp, millisec);
- 输入一个下层数据包:
// 收到一个下层数据包(比如 UDP 包)时需要调用
ikcp_input(kcp, buffer, len);
应用案例和最佳实践
商业案例
- 原神:米哈游的《原神》使用 KCP 降低游戏消息的传输耗时,提升操作的体验。
- SpatialOS:大型多人分布式游戏服务端引擎,使用 KCP 加速数据传输。
- 西山居:使用 KCP 进行游戏数据加速。
- 网易 CC:使用 KCP 加速视频推流,有效提高流畅性。
- 阿里云:阿里云的视频传输加速服务 GRTN 使用 KCP 进行音视频数据传输优化。
最佳实践
- 集成到现有协议栈:将
ikcp.h
和ikcp.c
文件拷贝到现有项目中,编写少量代码即可使用。 - 优化网络延迟:在网络不稳定的环境中,使用 KCP 可以显著降低延迟,提升用户体验。
典型生态项目
- KCPtun:基于 KCP 协议实现的穿隧软件,能将 TCP 流量转为 UDP 流量传输。
- yasio:一个跨平台专注于任意客户端程序的异步 socket 库,易于使用,相同的 API 操作 KCP/TCP/UDP。
- gouxp:用 Go 实现基于回调方式的 KCP 开发包,包含加解密和 FEC 支持,简单易用。
通过以上模块的介绍,您可以快速了解并上手 KCP 开源项目,并根据实际需求进行应用和优化。