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格式的。需要進行解析和相應的處理，例如提取音視頻幀、合併音視頻、播放等操作。