MobileRTCVideoPixelBufferExtraInfo Class Reference

Container for per-frame metadata accompanying an NV12 CVPixelBufferRef delivered via -onMobileRTCRender:framePixelBuffer:extraInfo:. More...

#include <MobileRTCVideoPixelBufferExtraInfo.h>

Inherits NSObject.

Properties
MobileRTCVideoRawDataRotation	rotation
	Frame rotation as reported by the sender. Matches the value previously delivered via the legacy selector's rotation: parameter.
MobileRTCFaceROIInfo *	faceROIInfo
	Per-frame face ROI metadata reported by the sender.

Detailed Description

Container for per-frame metadata accompanying an NV12 CVPixelBufferRef delivered via -onMobileRTCRender:framePixelBuffer:extraInfo:.

Aggregating future per-frame fields here keeps the delegate selector stable as new metadata is added. This object and the contained MobileRTCFaceROIInfo own their own data (the face ROI is captured when the callback fires), so they may be safely retained and used asynchronously after the callback returns. The CVPixelBuffer, however, must be retained separately via CVPixelBufferRetain - it is not owned by this container.

Note

The original -onMobileRTCRender:framePixelBuffer:rotation: selector remains supported for source compatibility but is marked deprecated. New code should adopt the extraInfo: variant to receive face ROI and any future metadata fields. If your delegate implements both selectors, both will be called for every frame; typically you should implement only one.

Definition at line 34 of file MobileRTCVideoPixelBufferExtraInfo.h.

Property Documentation

faceROIInfo

- (MobileRTCFaceROIInfo*) faceROIInfo

readatomicstrong

Per-frame face ROI metadata reported by the sender.

Always non-null; inspect -getFaceCount to determine whether any face was reported. Captures the face rectangles when the callback fires and may be retained independently of the host MobileRTCVideoPixelBufferExtraInfo for use after the callback returns.

Note

Face ROI is only supported on video streams.

Definition at line 54 of file MobileRTCVideoPixelBufferExtraInfo.h.

rotation

- (MobileRTCVideoRawDataRotation) rotation

readnonatomicassign

Frame rotation as reported by the sender. Matches the value previously delivered via the legacy selector's rotation: parameter.

Definition at line 41 of file MobileRTCVideoPixelBufferExtraInfo.h.