zego-api-media-publisher.h

Go to the documentation of this file.

//
//  zego-api-media-publisher.h
//  该模块可以直推经过特殊处理的本地 mp4 文件。如果要推在线多媒体资源，请使用 MEDIAPLAYER 模块
//
//  mp4 文件要求：只包含 I 帧和 P 帧，不能侌有 B 帧，gop 值为 2s, 音频格式为 AAC 
//  视频的帧率、码率、分辨率与初始化 SDK 时设置的帧率、码率、分辨率保持一致;
//
//  相较于使用 MEDIAPLAYER 推本地 mp4 文件有如下几个优点：
//  1. 减少系统资源开销，无需经过本地解码再编码的过程；
//  2. 无须关注外部采集接口，简化 API 调用逻辑；
//
//  Copyright © 2018年 Zego. All rights reserved.
//
 
#ifndef zego_api_media_publisher_h
#define zego_api_media_publisher_h
 
#include "zego-api-defines.h"
 
namespace ZEGO
{
namespace MEDIAPUBLISHER
{
    enum
    {
        ERROR_NONE = 0,
        ERROR_FILE = -1,
        ERROR_PATH = -2,
        ERROR_CODEC = -3,
        ERROR_TS_GO_BACK = -4,
        ERROR_DELAY_QUEUE_FULL = -5,
        ERROR_SAMPLERATE = -6, 
    };
 
    enum MediaPublishMode
    {
        MediaPublishModeBothVideoAndAudio = 0,
        MediaPublishModeOnlyVideo = 1,
    };
 
    struct MediaPublisherConfig
    {
        // 推流器的模式
        MediaPublishMode mode = MediaPublishModeBothVideoAndAudio;
    };
 
    class PublisherEventCallback {
    public:
        virtual void OnStart(AV::PublishChannelIndex channelIdx) = 0;
 
        virtual void OnStop(AV::PublishChannelIndex channelIdx) = 0;
 
        virtual void OnFileOpen(const char* path, AV::PublishChannelIndex channelIdx) = 0;
 
        virtual void OnFileClose(const char* path, int code, AV::PublishChannelIndex channelIdx) = 0;
 
        virtual void OnFileDataBegin(const char* path, AV::PublishChannelIndex channelIdx) = 0;
 
        virtual void OnFileDataEnd(const char* path, AV::PublishChannelIndex channelIdx) = 0;
    };
 
    ZEGOAVKIT_API void Create(AV::PublishChannelIndex channelIdx = AV::PublishChannelIndex::PUBLISH_CHN_MAIN);
 
    ZEGOAVKIT_API void CreateWithConfig(MediaPublisherConfig *config, AV::PublishChannelIndex channelIdx = AV::PublishChannelIndex::PUBLISH_CHN_MAIN);
    
    ZEGOAVKIT_API void Destroy(AV::PublishChannelIndex channelIdx = AV::PublishChannelIndex::PUBLISH_CHN_MAIN);
 
    ZEGOAVKIT_API void AddPath(const char* path, bool clear, AV::PublishChannelIndex channelIdx = AV::PublishChannelIndex::PUBLISH_CHN_MAIN);
 
    ZEGOAVKIT_API void Reset(AV::PublishChannelIndex channelIdx = AV::PublishChannelIndex::PUBLISH_CHN_MAIN);
 
    ZEGOAVKIT_API void SetVideoPtsDelay(int delay_ms, AV::PublishChannelIndex channelIdx = AV::PublishChannelIndex::PUBLISH_CHN_MAIN);
 
    ZEGOAVKIT_API void SeekTo(long timestamp_ms, AV::PublishChannelIndex channelIdx = AV::PublishChannelIndex::PUBLISH_CHN_MAIN);
 
    ZEGOAVKIT_API long GetDuration(AV::PublishChannelIndex channelIdx = AV::PublishChannelIndex::PUBLISH_CHN_MAIN);
 
    ZEGOAVKIT_API long GetCurrentDuration(AV::PublishChannelIndex channelIdx = AV::PublishChannelIndex::PUBLISH_CHN_MAIN);
 
    ZEGOAVKIT_API void SetEventCallback(PublisherEventCallback* callback, AV::PublishChannelIndex channelIdx = AV::PublishChannelIndex::PUBLISH_CHN_MAIN);
}
}
 
#endif