librtmp详解

一、librtmp介绍

librtmp是一个开源的基于C语言的库，提供了一个连接RTMP服务器，发送和接收RTMP流的API。它可以用来开发流媒体播放器，网络直播等应用。它的主要特点是快速、稳定和低延迟。

librtmp支持RTMP，RTMPS，RTMPE和RTMPTE加密协议等多种协议。除此之外，它还支持PProxy，PPlayer和appspot的代理服务器协议。在Linux下，使用librtmp开发的应用可以支持Windows，Android等多种系统平台。

librtmp的核心代码是基于ffmpeg中的libavformat库实现的。它依赖于libz, libssl, libcrypto等第三方库，需要自行编译安装。

二、librtmp的使用

1. 连接RTMP服务器

#include 

RTMP *rtmp = RTMP_Alloc();
RTMP_Init(rtmp);
rtmp->Link.timeout = 5;
RTMP_SetupURL(rtmp, "rtmp://ip:port/app/path");
RTMP_EnableWrite(rtmp);
RTMP_Connect(rtmp, NULL);
if (!RTMP_ConnectStream(rtmp, 0)) {
    printf("connect server failed\n");
    return -1;
}

RTMP_Alloc()函数用于分配一个RTMP句柄，RTMP_Init()函数用于初始化该句柄，RTMP_SetupURL()函数用于设置RTMP服务器地址，RTMP_EnableWrite()函数用于启动写入流的模式，RTMP_Connect()用于连接服务器，RTMP_ConnectStream()用于连接流。其中timeout为连接超时时间，单位为秒，0表示没有超时限制。

2. 发送流媒体数据

uint8_t* buffer = new uint8_t[1024 * 1024];
unsigned int current_timestamp = 0;
while (1) {
    memset(buffer, 0, 1024 * 1024);
    // 获取一帧流媒体数据
    get_frame_data(buffer, &current_timestamp);
    // 发送视频帧
    RTMP_SendVideo(rtmp, buffer, length, current_timestamp);
}

get_frame_data()函数用于获取流媒体数据，RTMP_SendVideo()函数用于发送视频数据，同样，也有RTMP_SendAudio()函数用于发送音频数据。注意，current_timestamp是流媒体每一帧的时间戳，单位为毫秒。

3. 接收流媒体数据

RTMP_ClientPacket client_packet;
int read_size = RTMP_ReadPacket(rtmp, &client_packet);
if (read_size && RTMPPacket_IsReady(&client_packet)) {
    // 处理接收到的音视频数据
    switch (client_packet.m_packetType) {
        case RTMP_PACKET_TYPE_VIDEO:
            handle_video_data(client_packet.m_body, client_packet.m_nBodySize);
            break;
        case RTMP_PACKET_TYPE_AUDIO:
            handle_audio_data(client_packet.m_body, client_packet.m_nBodySize);
            break;
        default:
            break;
    }
}

RTMP_ReadPacket()函数用于读取网络数据，判断是否接收到完整的音视频数据包，然后处理音视频数据。RTMP_PACKET_TYPE_VIDEO表示接收到视频数据，RTMP_PACKET_TYPE_AUDIO表示接收到音频数据。

三、librtmp常见问题

1. API函数的返回值

librtmp中大量的API函数都返回整数类型的值，这些值通常是表示函数的完成情况和错误代码。需要注意的是，当值小于0时，表示函数执行出现错误，需要根据返回值进行相应的错误处理。

2. 连接RTMP服务器的超时时间

连接RTMP服务器的超时时间可以通过设置RTMP的timeout参数进行设定。如果连接超时，需要对错误进行相应的处理。

3. 编译librtmp时的问题

在linux系统中编译librtmp时，需要依赖openssl等第三方库。在编译的过程中需要确保这些库的头文件路径和库文件路径设置正确。

4. 接收的音视频数据格式

在使用librtmp接收音视频流时，得到的音视频数据是FLV格式的。需要进行解析和相应的处理，例如提取音视频帧、合并音视频、播放等操作。