영상 재생 API¶

미디어 플레이어 API는 oasis::ui 네임스페이스 범주에서 호출됩니다.

미디어 플레이어는 MediaObserver로 유도된 사용자 정의 observer 객체를 통하여 진행 상황이나 재생중 발생하는 오류 등의 이벤트를 받을 수 있습니다.

헤더 파일¶

OasisPlayer.h

함수¶

Player 생성에 필요한 key-value map은 아래와 같습니다.

각 영상 트랙에 대한 key-value map 값은 각 키값 앞에 prefix로 channel<N>- 이 붙습니다. <N>은 1부터 시작하여 1씩 증가합니다.

MediaTrackInfo 정의는 아래 구조체 부분을 참고합니다.

구조체¶

​

예제¶

아래는 녹화 파일의 영상 트랙 하나를 재생하는 미디어 플레이어 예입니다.

Oasis를 초기화 합니다.

#define OFFS_QUEUE_SIZE_KBYTES  (40*1024)
#define OFFS_CACHE_SIZE_KBYTES  (1024)
#define MEDIA_CACHE_SIZE_KBYTES (40*1024)


oasis::key_value_map_t parameters;

parameters["offs-qsize-max"] = std::to_string(OFFS_QUEUE_SIZE_KBYTES);
parameters["offs-overwrite-if-exist"] = "1";
parameters["offs-cache-size"] = std::to_string(OFFS_CACHE_SIZE_KBYTES);
parameters["media-cache-size"] = std::to_string(MEDIA_CACHE_SIZE_KBYTES);

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

오디오 출력(sink) 장치를 초기화 합니다.

    parameters.clear();

#if 0
#define SND_PATH "default"
#else
#define SND_PATH "hw:0,0"
#endif

parameters["types"]="sink";
parameters["path"]=SND_PATH;
parameters["always-on"]="0";
parameters["aec-disabled"]="1";
parameters["snd-input-channels"]="2";
parameters["snd-input-sample-size"]="16";
parameters["snd-input-sampling-duration-msec"]="40";
parameters["snd-input-sampling-rate"]="48000";

createAudioDevice(parameters);

디스프레이 장치를 초기화 합니다.

parameters.clear();

parameters["memory-type"] = "ion"; //cma
parameters["screen-width"] = "480";
parameters["screen-height"] = "320";

display::setup(parameters);

GUI를 설정합니다. 여기 예에서는 터치를 사용하지 않습니다.

parameters.clear();

parameters["system-font-size"] = "10";
parameters["system-font-path"] = "/mnt/sd/consola.ttf";
parameters["display-rotation"] = "0";
parameters["enable-touch"] = "0";

err = ui::setup(parameters);
if (err < 0) {
    DLOG(DLOG_ERROR, "Oasis ui::setup failed\n");
    return -1;
}

미디어 플레이어를 초기화 합니다.

parameters.clear();

// 기본 스크린 객체를 얻고 너비와 높이를 미디어플레이어에 적용합니다.
ui::ScreenRef screen = ui::getDefaultScreen();

int32_t screen_width = ui::screenWidth(screen);
int32_t screen_height = ui::screenHeight(screen);


// MediaObserver 에서 유도된 사용자 정의 객체를 생성합니다.
std::shared_ptr<MyPlayingObserver> observer = std::make_shared<MyPlayingObserver>();

// 필요할 경우 rotation과 snd-path 도 지정합니다. 
// snd-path는 오디오 장치 생성시 지정한 장치 경로이어야 합니다.
parameters["rotation"] = std::to_string(rotation);
parameters["snd-path"] = SND_PATH;
parameters["channel-count"] = "1";
parameters["primary-channel"] = "1";

// track-id가 '0'고 실제 파일의 첫 트랙 ID가 '1'이어도 순차적으로 할당됩니다.
parameters["channel1-track-id"] = "0";
parameters["channel1-visible"] = "1";
parameters["channel1-rotation"] = std::to_string(rotation);
// 재생 화면을 전체 스크린으로 지정합니다.
parameters["channel1-x"] = "0";
parameters["channel1-y"] = "0";
parameters["channel1-width"] = std::to_string(screen_width);
parameters["channel1-height"] = std::to_string(screen_height);
parameters["channel1-zorder"] = "0";

ui::PlayerRef player = ui::createPlayer(0, parameters);
// setup the player object
observer->player_ = player;

화면을 구성합니다. 최상위 Window 객체에 Fixed 레이아웃 컨테이너를 이용하고, 재생화면은 전체화면으로 설정합니다.

ui::WindowRef player_panel = ui::createWindow("Player1");

ui::FixedRef fixed_layout = ui::createFixed();
ui::containerAdd(player_panel, fixed_layout);

ui::setFixedSize(player, screen_width, screen_height);
ui::fixedPut(fixed_layout, player, 0, 0);
ui::screenAdd(screen, player_panel);

ui::setVisible(player_panel, true);

재생을 시작합니다.

err = ui::playerStart(player, file_path, observer, nullptr);

// 트랙 정보를 얻습니다.
std::vector<MediaTrackInfo> tracks;
ui::playerGetVideoTracks(player, tracks);

재생 중 10초 앞으로 재생 위치를 변경하는 예입니다.

if (ui::playerIsPlaying(player) || ui::playerIsPaused(player)) {
    int64_t duration = ui::playerGetDuraitonUs(player);
    int64_t timestamp = ui::playerGetCurrentTimestampUs(player);
    timestamp += 10*1000000ll;
    if(timestamp > duration-10*1000000ll) {
        timestamp = duration-10*1000000ll;
    }
    if(timestamp < 0) {
        timestamp = 0ll;
    }
    err = ui::playerSeek(player, timestamp);
}

재생 중 화면 위치와 크기를 변경하는 예입니다.

ui::playerSetRect(player, track_id, 100, 100, 320, 240)

재생을 중지합니다.

ui::playerStop(player);

아래는 전체 코드입니다.

#include "OasisAPI.h"
#include "OasisLog.h"
#include "OasisMedia.h"
#include "OasisUI.h"
#include "OasisFS.h"
#include "OasisUtil.h"
#include "OasisDisplay.h"
#include "OasisInference.h"

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

#include <signal.h>

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


using namespace oasis;

#define OFFS_QUEUE_SIZE_KBYTES  (40*1024)
#define OFFS_CACHE_SIZE_KBYTES  (1024)
#define OFFS_WRITE_ALIGNMENT_BYTES  8192
#define MEDIA_CACHE_SIZE_KBYTES (40*1024)


static bool continue_playing = true;
void cancel_handler(int signum)
{
    continue_playing = false;
}


class MyPlayingObserver : public MediaObserver {
public:
    virtual void onStarted(void *user_data, const char *file_path) {
        fprintf(stdout, "Playing started, file path \"%s\"\n", file_path);
    }

    virtual void onStopped(void *user_data, media_report_reason_t reason, void *details) {
        fprintf(stdout, "Playing stopped, reason: %d\n", reason);
        continue_playing = false;
    }

    virtual void onFileChanged(void *user_data, const char *new_file_path) {}

    virtual void onError(void *user_data, media_report_reason_t reason, void *details) {
        fprintf(stdout, "Playing error, reason: %d (%s)\n", reason, mediaReportReasonString(reason));
        continue_playing = false;
    }

    virtual void onInfo(void *user_data, MediaInfo *info) {
        int h, m, s, u;
        parseUsec(info->durationUs, h, m, s, u);
        int h1, m1, s1, u1;
        parseUsec(info->currentTimestampUs, h1, m1, s1, u1);

        fprintf(stdout, "\rPlaying duration %02d:%02d:%02d.%06d, current %02d:%02d:%02d.%06d            ", h, m, s, u, h1, m1, s1, u1);
        fflush(stdout);
    }

    virtual void onPaused(void *user_data, MediaInfo *info) {
        fprintf(stdout, "Paused duration %lld usec, current %lld usec\n", info->durationUs, info->currentTimestampUs);
    }

    virtual void onResumed(void *user_data, MediaInfo *info) {
        fprintf(stdout, "Resumed duration %lld usec, current %lld usec\n", info->durationUs, info->currentTimestampUs);
    }

    ui::PlayerRef player_;
};

static bool isFile(const char *path)
{
    struct stat path_stat;
    stat(path, &path_stat);
    return S_ISREG(path_stat.st_mode);
}


void printUsage(const char *pgname)
{
    fprintf(stderr, "USAGE: %s [-r <rotation. 90, 270>] <mp4 or avi file-path>\n", pgname);
}


int main(int argc, char *argv[])
{
    int32_t err;
    int c;
    int32_t rotation = 0;
    std::vector<MediaTrackInfo> tracks;
    bool is_playing = false;
    int32_t track_id = -1;

    opterr = 0;
    while ((c = getopt(argc, argv, "r:h")) != -1) {
        switch (c) {
        case 'r':
            if(optarg == nullptr) {
                fprintf(stderr, "error: bad option argument '%c'\n", optopt);
                return -1;
            }
            rotation = atoi(optarg);
            if(rotation != 0 && rotation != 90 /*&& rotation != 180*/ && rotation != 270) {
                fprintf(stderr, "bad rotation: %d\n", rotation);
                return -1;
            }
            break;
        case 'h':
        default:
            printUsage(argv[0]);
            return -1;
        }
    }

    if(argc-optind < 1) {
        fprintf(stderr, "error: invalid or insufficient arguments (%d, %d)\n", argc, optind);
        printUsage(argv[0]);
        return -1;
    }

    if (access(argv[optind], F_OK) != 0) {
        fprintf(stderr, "\"%s\" not found\n", argv[optind]);
        return -1;
    }

    std::string file_path = argv[optind];
    if(!isFile(dir_path.c_str())) {
        fprintf(stderr, "\"%s\" not type of file\n", argv[optind]);
        return -1;
    }

    signal(SIGINT, cancel_handler);

    oasis::key_value_map_t parameters;

    ////////////////////////////////////////////////////////////////////////////////////////////
    // init

    parameters["offs-qsize-max"] = std::to_string(OFFS_QUEUE_SIZE_KBYTES);
    parameters["offs-overwrite-if-exist"] = "1";
    parameters["offs-cache-size"] = std::to_string(OFFS_CACHE_SIZE_KBYTES);
    parameters["media-cache-size"] = std::to_string(MEDIA_CACHE_SIZE_KBYTES);

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

    ////////////////////////////////////////////////////////////////////////////////////////////
    // audio
    parameters.clear();
#if 0
    #define SND_PATH "default"
#else
    #define SND_PATH "hw:0,0"
#endif

    parameters["types"]="sink";
    parameters["path"]=SND_PATH;
    parameters["always-on"]="0";
    parameters["aec-disabled"]="1";
    parameters["snd-input-channels"]="2";
    parameters["snd-input-sample-size"]="16";
    parameters["snd-input-sampling-duration-msec"]="40";
    parameters["snd-input-sampling-rate"]="48000";

    createAudioDevice(parameters);

    ////////////////////////////////////////////////////////////////////////////////////////////
    // display setup
    parameters.clear();

    parameters["memory-type"] = "ion"; //cma
    parameters["screen-width"] = "480";
    parameters["screen-height"] = "320";

    display::setup(parameters);


    //////////////////////////////////////////////////////////////////////////////////////////
    // ui setup
    parameters.clear();

    parameters["system-font-size"] = "10";
    parameters["system-font-path"] = "/mnt/sd/consola.ttf";
    parameters["display-rotation"] = "0";
    parameters["enable-touch"] = "0";

    err = ui::setup(parameters);
    if (err < 0) {
        DLOG(DLOG_ERROR, "Oasis ui::setup failed\n");
        return -1;
    }

    ui::ScreenRef screen = ui::getDefaultScreen();
    //ASSERT(screen != nullptr);

    int32_t screen_width = ui::screenWidth(screen);
    int32_t screen_height = ui::screenHeight(screen);

    //////////////////////////////////////////////////////////////////////////////////////////

    parameters.clear();

    parameters["rotation"] = std::to_string(rotation);


    /////////////////////////////////////////////////////////////////////////
    //player_panel
    ui::WindowRef player_panel = ui::createWindow("Player1");
    //ASSERT(player_panel != nullptr);

    ui::FixedRef fixed_layout = ui::createFixed();
    ui::containerAdd(player_panel, fixed_layout);

    std::shared_ptr<MyPlayingObserver> observer = std::make_shared<MyPlayingObserver>();

    parameters["snd-path"] = SND_PATH;

    parameters["channel-count"] = "1";
    parameters["primary-channel"] = "1";

    parameters["channel1-track-id"] = "0";
    parameters["channel1-visible"] = "1";
    parameters["channel1-rotation"] = std::to_string(rotation);
    parameters["channel1-x"] = "0";
    parameters["channel1-y"] = "0";
    parameters["channel1-width"] = std::to_string(screen_width);
    parameters["channel1-height"] = std::to_string(screen_height);
    parameters["channel1-zorder"] = "0";

    ui::PlayerRef player = ui::createPlayer(0, parameters);
    //setup the player object
    observer->player_ = player;

    ui::setFixedSize(player, screen_width, screen_height);
    ui::fixedPut(fixed_layout, player, 0, 0);
    ui::screenAdd(screen, player_panel);

    ui::setVisible(player_panel, true);

    err = ui::playerStart(player, file_path.c_str(), observer, nullptr);

    if(err != 0) {
        fprintf(stderr, "\"%s\" failed to play!\n", file_path.c_str());
    } else {
        is_playing = true;
        ui::playerGetVideoTracks(player, tracks);
        if(tracks.size() > 0) {
            track_id = tracks[0].id;
        }
        fprintf(stdout, "video track count %d, 1st track id %d\n", tracks.size(), track_id);
    }

    do {
        usleep(100000);
    } while (continue_playing);

    if(is_playing) {
        ui::playerStop(player);
    }

    err = ui::cleanup();

    oasis::finalize();

    return 0;
}