zego-api-media-recorder.h

Go to the documentation of this file.

#ifndef zego_api_media_recorder_h
#define zego_api_media_recorder_h
 
#include "zego-api-defines.h"
 
namespace ZEGO
{
    namespace MEDIA_RECORDER
    {
     
        enum ZegoMediaRecordType
        {
            ZEGO_MEDIA_RECORD_AUDIO = 1,     
            ZEGO_MEDIA_RECORD_VIDEO = 2,     
            ZEGO_MEDIA_RECORD_BOTH  = 3      
        };
        
        enum ZegoMediaRecordChannelIndex
        {
            ZEGO_MEDIA_RECORD_CHN_MAIN = 0,    
            ZEGO_MEDIA_RECORD_CHN_AUX,         
            ZEGO_MEDIA_RECORD_CHN_THIRD,       
            ZEGO_MEDIA_RECORD_CHN_FOURTH,      
        };
        
        enum ZegoMediaRecordFormat
        {
            ZEGO_MEDIA_RECORD_FLV = 1,       
            ZEGO_MEDIA_RECORD_MP4 = 2,       
            ZEGO_MEDIA_RECORD_AAC = 4,       
            ZEGO_MEDIA_RECORD_M3U = 7        
        };
 
        enum ZegoMediaRecordErrorCode
        {
            ZEGO_MR_ERROR_CODE_SUCCESS = 0,
            ZEGO_MR_ERROR_CODE_PATH_TOO_LONG,
            ZEGO_MR_ERROR_CODE_INIT_FAILED,
            ZEGO_MR_ERROR_CODE_OPEN_FILE_FAILED,
            ZEGO_MR_ERROR_CODE_WRITE_HEADER_FAILED,
            ZEGO_MR_ERROR_CODE_RECORD_BEGIN,
            ZEGO_MR_ERROR_CODE_RECORD_END,
            ZEGO_MR_ERROR_CODE_NO_SPACE,
            ZEGO_MR_ERROR_CODE_BAD_FILE_DESC,
            ZEGO_MR_ERROR_CODE_IO_ERROR,
        };
 
        struct ZegoMediaRecordConfig
        {
            ZegoMediaRecordChannelIndex channelIndex;
 
            ZegoMediaRecordType recordType;
 
            const char* storagePath;
 
            bool enableStatusCallback;
 
            int interval;
 
            ZegoMediaRecordFormat recordFormat;
 
            bool isFragment;
            
            const char* config;
 
            ZegoMediaRecordConfig()
            {
                channelIndex = ZegoMediaRecordChannelIndex::ZEGO_MEDIA_RECORD_CHN_MAIN;
                recordType = ZegoMediaRecordType::ZEGO_MEDIA_RECORD_BOTH;
                storagePath = nullptr;
                enableStatusCallback = false;
                interval = 3000;
                recordFormat = ZegoMediaRecordFormat::ZEGO_MEDIA_RECORD_FLV;
                isFragment = false;
                config = nullptr;
            }
        };
 
        class IZegoMediaRecordCallback
        {
        public:
            virtual void OnMediaRecord(int errCode, ZegoMediaRecordChannelIndex channelIndex, const char* storagePath) = 0;
            
            virtual void OnRecordStatusUpdate(const ZegoMediaRecordChannelIndex channelIndex, const char* storagePath, const unsigned int duration, const unsigned int fileSize) {}
            
            virtual void OnRecordStatusUpdateWithQuality(const ZegoMediaRecordChannelIndex channelIndex, const char* storagePath, const unsigned int duration, const unsigned int fileSize, const AV::PublishQuality& quality) {}
            
            virtual ~ IZegoMediaRecordCallback() {}
        };
        
        ZEGOAVKIT_API bool SetZegoMediaRecordCallback(IZegoMediaRecordCallback* pCB);
        
        ZEGOAVKIT_API bool StartRecord(ZegoMediaRecordChannelIndex channelIndex, ZegoMediaRecordType recordType, const char* storagePath, const bool enableStatusCallback = false, const int interval = 3000, ZegoMediaRecordFormat recordFormat = ZegoMediaRecordFormat::ZEGO_MEDIA_RECORD_FLV, bool isFragment = false);
        
        ZEGOAVKIT_API bool StartRecord(ZegoMediaRecordConfig config);
 
        ZEGOAVKIT_API void StopRecord(ZegoMediaRecordChannelIndex channelIndex);
    }
}
 
#endif