RTSP API¶

Oasis는 RTSP 서버를 지원합니다.

지원하는 영상 코덱은 H264, H265이며, 음성 코덱은 OPUS, AAC, MP3, PCM 입니다. 라이브 스트리밍 경우, OPUS가 디폴트 코덱으로 동작합니다.

헤더 파일¶

OasisRtsp.h

URL 양식¶

VLC 등 클라이언트 미디어 플레이어에서 Oasis RTSP 서버에 접속 시 사용하는 URL 양식은 아래와 같습니다.

rtsp://<서버주소>[:포트번호][/RTSP 스트리밍 세션 환경설정 key-value 목록]/<스트리밍 목적지 경로>

• 서버주소 RTSP 서버주소입니다.

• 포트번호를 사용하지 않을 경우, 554번이 기본값입니다.

• RTSP 스트리밍 세션 환경설정 key-value 목록 은 옵션 사항으로 아래와 같은 key-value 를 지원합니다. 각 key-value 쌓은 "&"로 구분됩니다.

• 스트리밍 목적지 경로 는 스트리밍할 대상을 지정합니다. 라이브 카메라 경로와 파일 경로를 지정할 수 있습니다. 파일 경로의 경우, RTSP 서버 생성시 지정한 root-dir 내에 위치해야 합니다. 라이브 카메라 경로는 Live/<카메라 장치 ID>와 같습니다. <카메라 장치 ID>는 oasis::configCameras API에서 key-value map으로 지정한 값입니다. 파일 경로의 경우, root-dir을 기준으로 상대 경로를 지정합니다. 만일 영상 파일에 복수 개의 영상 트랙이 있을 경우, /<파일 경로>/TrackID=<트랙번호> 형식으로 특정 트랙을 지정할 수 있습니다.

아래는 URL 예입니다.

RtspEventDelegate 인터페이스¶

사용자는 RTSP 서버와 연결된 클라이언트간 스트리밍시 발생하는 이벤트를 RtspEventDelegate 인터페이스에서 유도된 객체를 생성하여 확인할 수 있습니다.

RTSP 서버 동작에 반드시 필요한 인터페이스는 아닙니다.

class RtspEventDelegate : public std::enable_shared_from_this<RtspEventDelegate>
{
public:
    RtspEventDelegate();
    virtual ~RtspEventDelegate();

public:
    virtual void onDescription(const char *uri, const char *remote, const char *sdp);
    virtual void onSetup(const char *uri, const char *remote, const char *transport_line);
    virtual void onPlay(const char *uri, const char *remote, const char *rtp_info);
    virtual void onTeardown(const char *uri, const char *remote);
    virtual void onPause(const char *uri, const char *remote);
    virtual void onError(int error_code, const char *error_msg, const char *error_desc);
    virtual void onClosed(const char *uri, const char *remote);
};

RTSP 서버가 보내는 에러 응답 코드는 아래와 같습니다.

함수¶

​

예제¶

아래는 RTSP 서버 예입니다.

#include "OasisAPI.h"
#include "OasisLog.h"
#include "OasisRtsp.h"

#include <thread>
#include <mutex>
#include <memory>
#include <condition_variable>

#include <sys/types.h>
#include <sys/stat.h>
#include <unistd.h>

#include <signal.h>

#define DLOG_TRACE  0x00080000

#undef DLOG_FLAGS
#define  DLOG_FLAGS (DLOG_FLAGS_DEFAULT|DLOG_TRACE/**/)

#undef DLOG_TAG
#define DLOG_TAG "RTSP"

#define RTSP_PORT  554

using namespace oasis;

namespace oasis {
    uint64_t getFreeMemorySize();
}

static bool continuing = true;

void cancel_handler(int signum)
{
    continuing = false;
}



int main(int argc, char* argv[])
{
    int32_t err;
    int32_t c;
    std::thread t2, t3;

    uint16_t rtsp_port = RTSP_PORT;
    RtspServerRef rtsp_server;

    oasis::key_value_map_t parameters;

    parameters["offs-disable"] = "1";
    if(oasis::initialize(parameters) < 0) {
        DLOG(DLOG_ERROR, "Oasis init failed\n");
        return -1;
    }

    //Oasis set SIGINT
    signal(SIGINT, cancel_handler);


    // config cameras
    // ...

    // RTSP 서버 생성

    parameters.clear();
    parameters["port"] = std::to_string(rtsp_port);
    parameters["root-dir"] = "/mnt/extsd";
    parameters["remote-pool-size"] = std::to_string(20); //max con-current network connections
    parameters["scheduler-size"] = std::to_string(10); //max working threads
    parameters["upstreamer-size"] = std::to_string(10); //max working threads
    parameters["transmitter-size"] = std::to_string(15);
    parameters["timer-size"] = std::to_string(3);
    parameters["file-session-max"] = std::to_string(1);  //0: unlimited
    parameters["live-session-max"] = std::to_string(6);  //0: unlimited 
    parameters["linger-time-max"] = std::to_string(1000);   
    parameters["rtp-data-size-max"] = std::to_string(1024); 
    parameters["rtp-packet-pool-count-max"] = std::to_string(6);    
    parameters["rtp-packet-pool-size"] = std::to_string(256);   

    rtsp_server = createRtspServer(parameters);
    if(rtsp_server) {
        // RTSP 서버 시작
        err = oasis::startRtspServer(rtsp_server);
        ASSERT(err == 0);
        if(err < 0) {
            DLOG(DLOG_ERROR, "RTSP server failed\n");
            goto done;
        }
        DLOG(DLOG_TRACE, "RTSP running at %d...\n", rtsp_port);
    }

    do {
        usleep(10000);
    } while(continuing);

if(rtsp_server) {
        oasis::destroyRtspServer(rtsp_server);
    }

    oasis::finalize();

    return 0;
}