MediaObserver 인터페이스¶

재생과 녹화 컴포넌트는 MediaObserver에서 유도된 사용자 정의 Observer 객체를 통하여 이벤트 등을 처리합니다.

oasis::MediaObserver는 OasisMedia.h에 아래와 같이 정의되어 있습니다.

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

    //recording or playing started and stopped
    virtual void onStarted(void *user_data, const char *file_path);
    virtual void onStopped(void *user_data, media_report_reason_t reason, void *details);
    //recording a new file
    virtual void onFileChanged(void *user_data, const char *new_file_path);
    virtual void onError(void *user_data, media_report_reason_t reason, void *details);

    //periodic report every 1 second.
    virtual void onInfo(void *user_data, MediaInfo *info);
    virtual void onInfoEx(void *user_data, MediaInfoEx *info);

    //player paused and resumed
    virtual void onPaused(void *user_data, MediaInfo *info);
    virtual void onResumed(void *user_data, MediaInfo *info);

    //event recording started and completed(aborted)
    virtual void onEventRecordingStarted(void *user_data, media_report_reason_t reason, const char *file_path);
    virtual void onEventRecordingCompleted(void *user_data, media_report_reason_t reason, const char *file_path);

    //motion recording started and completed(aborted)
    virtual void onMotionRecordingStarted(void *user_data, media_report_reason_t reason, const char *file_path);
    virtual void onMotionRecordingCompleted(void *user_data, media_report_reason_t reason, const char *file_path);

    virtual void queryNewFilePath(void *user_data, recording_mode_t file_type, bool rear_camera_on, bool sound_on, std::string &file_path);

    virtual void onSnapshotCompleted(void *user_data, uint32_t snapshot_id, int32_t camera_id, int error, const std::vector<char> &jpeg_image_data, const struct timeval &timestamp);
};

헤더 파일¶

OasisMedia.h

인터페이스 함수¶

일반 media_report_reason_t 상수 값은 아래와 같습니다.

녹화 컴포넌트의 경우, media_report_reason_t 상수 값은 아래와 같습니다.

재생 컴포넌트의 경우, media_report_reason_t 상수 값은 아래와 같습니다.

구조체¶

​

예제¶

녹화 컴포넌트의 사용자는 MediaObserver를 base class로 하여 클래스를 정의하고, oasis::startRecording 함수 호출 시 매개변수로 전달합니다. 아래는 MyRecordingObserver를 생성하고 oasis::startRecording에 전달하는 예입니다.

std::shared_ptr<MyRecordingObserver> recording_observer = std::make_shared<MyRecordingObserver>();
RecorderRef recorder = createRecorder(parameters);
startRecording(recorder, recording_observer, nullptr /*user_data*/);