tencent cloud

@interface V2TXLivePlayer : NSObject
/**
 * @brief Set callbacks for the player<br/>
 *        After setting callbacks, you can listen for events of V2TXLivePlayer,
 *       including the player status, playback volume, first audio/video frame, statistics, and warning and error messages.
 *
 * @param observer Target object for the player’s callbacks. For more information, see {@link V2TXLivePlayerObserver}
 */
- (void)setObserver:(id<V2TXLivePlayerObserver>)observer;


/**
 * @brief Video frame information
 *        V2TXLiveVideoFrame is the raw data that describes a video frame before encoding or after decoding
 * @note It is used during custom video capturing to package the video frames to be sent, and during custom video rendering to get the packaged video frames
 */
 @interface V2TXLiveVideoFrame : NSObject

///**Field meaning:** video pixel format
///**Recommended value:** V2TXLivePixelFormatNV12
@property(nonatomic, assign) V2TXLivePixelFormat pixelFormat;

///**Field meaning:** video data container format
///**Recommended value:** V2TXLiveBufferTypePixelBuffer
@property(nonatomic, assign) V2TXLiveBufferType bufferType;

///**Field meaning:** video data when bufferType is V2TXLiveBufferTypeNSData
@property(nonatomic, strong, nullable) NSData *data;

///**Field meaning:** video data when bufferType is V2TXLiveBufferTypePixelBuffer
@property(nonatomic, assign, nullable) CVPixelBufferRef pixelBuffer;

///**Field meaning:** video width
@property(nonatomic, assign) NSUInteger width;

///**Field meaning:** video height
@property(nonatomic, assign) NSUInteger height;

///**Field meaning:** clockwise rotation of video
@property(nonatomic, assign) V2TXLiveRotation rotation;

/// **Field description:** video texture ID
@property (nonatomic, assign) GLuint textureId;

@end


@protocol V2TXLivePlayerObserver <NSObject>
@optional
/**
 * @brief Custom video rendering callback
 *
 * @note  You will receive this callback after calling [enableCustomRendering](@ref V2TXLivePlayer#enableCustomRendering:pixelFormat:bufferType:) to enable custom video rendering
 *
 * @param videoFrame Video frame data {@link V2TXLiveVideoFrame}
 */
- (void)onRenderVideoFrame:(id<V2TXLivePlayer>)player
                     frame:(V2TXLiveVideoFrame *)videoFrame
                 @end


public abstract void setObserver(V2TXLivePlayerObserver observer)


public final static class V2TXLiveVideoFrame
{
    /// Video pixel format
    public V2TXLivePixelFormat pixelFormat = V2TXLivePixelFormat.V2TXLivePixelFormatUnknown;
    /// Video data container format
    public V2TXLiveBufferType bufferType   = V2TXLiveBufferType.V2TXLiveBufferTypeUnknown;
    /// Video texture pack
    public V2TXLiveTexture texture;
    /// Video data
    public byte[]       data;
    /// Video data
    public ByteBuffer   buffer;
    /// Video width
    public int          width;
    /// Video height
    public int          height;
    /// Clockwise rotation of video
    public int          rotation;
}

public abstract class V2TXLivePlayerObserver {
    /**
     * Callback for custom video rendering
     *
     * @param player The player object sending this callback
     * @param videoFrame Video frame data {@link V2TXLiveVideoFrame}
     */
    void onRenderVideoFrame(V2TXLivePlayer player, V2TXLiveVideoFrame videoFrame);
}