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;
}