com.meicam.sdk.NvsVideoFrameRetriever Class Reference

Video frame extraction. More...

Public Member Functions
Bitmap	getFrameAtTime (long time, int videoFrameHeightGrade)
	Gets video frame image at a certain moment. More...
void	release ()
	Releases the related resources of video retriever class, and this class cannot continue to be used once the resource is released. More...
Bitmap	getFrameAtTimeWithCustomVideoFrameHeight (long time, int videoFrameHeight)
	Gets the video frame image at a certain moment. Users can customize the height of the video frame. More...
void	setFrameTimeTolerance (long timeTolerance)
	Set the time tolerance for acquiring video frames. The actual time of the generated images will be within the range [nowTime-timeTolerance，nowTime+timeTolerance] and may differ from the requested time for efficiency.Pass 0 for to request frame-accurate image generation; this may incur additional decoding delay.Default is 500000. More...

Static Public Attributes
Height level of the extracted video frame.
static final int	VIDEO_FRAME_HEIGHT_GRADE_360 = 0
	Video frame of 360 pixels in height. More...
static final int	VIDEO_FRAME_HEIGHT_GRADE_480 = 1
	Video frame of 480 pixels in height. More...
static final int	VIDEO_FRAME_HEIGHT_GRADE_720 = 2
Create videoFrameRetriever flags.
static final int	CREATE_RETRIEVER_FLAG_PREFERENTIAL_USE_HARDWARE_READER = 1
	Preferential use hardware reader. More...
static final int	CREATE_RETRIEVER_FLAG_PREFERENTIAL_EXPORT_HLG_RGB10A2_BITMAP = 2

Protected Member Functions
void	finalize () throws Throwable

Detailed Description

Video frame extraction.

The video frame extraction class can acquire the original video frame image at a certain moment.

Warning

In the NvsVideoFrameRetriever class, all public APIs can be used not only in the UI thread, but also across threads! ! !

Since

1.2.0

Member Function Documentation

finalize()

void com.meicam.sdk.NvsVideoFrameRetriever.finalize ( ) throws Throwable

inlineprotected

getFrameAtTime()

Bitmap com.meicam.sdk.NvsVideoFrameRetriever.getFrameAtTime ( long  time, int  videoFrameHeightGrade  )

inline

Gets video frame image at a certain moment.

Parameters

time	Timestamp of the frame (in microseconds).
videoFrameHeightGrade	Height level of the extracted video frame. For details, please refer to Height level of the extracted video frame.

Returns

Returns Bitmap object representing the video frame image at a certain moment.

getFrameAtTimeWithCustomVideoFrameHeight()

Bitmap com.meicam.sdk.NvsVideoFrameRetriever.getFrameAtTimeWithCustomVideoFrameHeight ( long  time, int  videoFrameHeight  )

inline

Gets the video frame image at a certain moment. Users can customize the height of the video frame.

Parameters

time	Timestamp of the frame (in microseconds).
videoFrameHeight	Custom video frame height.

Returns

Returns Bitmap object representing the video frame image at a certain moment.

Since

1.15.0

release()

void com.meicam.sdk.NvsVideoFrameRetriever.release ( )

inline

Releases the related resources of video retriever class, and this class cannot continue to be used once the resource is released.

Since

1.14.1

setFrameTimeTolerance()

void com.meicam.sdk.NvsVideoFrameRetriever.setFrameTimeTolerance ( long  timeTolerance )

inline

Set the time tolerance for acquiring video frames. The actual time of the generated images will be within the range [nowTime-timeTolerance，nowTime+timeTolerance] and may differ from the requested time for efficiency.Pass 0 for to request frame-accurate image generation; this may incur additional decoding delay.Default is 500000.

Parameters

timeTolerance

the time value (in microseconds)

Since

2.20.0

Member Data Documentation

CREATE_RETRIEVER_FLAG_PREFERENTIAL_EXPORT_HLG_RGB10A2_BITMAP

final int com.meicam.sdk.NvsVideoFrameRetriever.CREATE_RETRIEVER_FLAG_PREFERENTIAL_EXPORT_HLG_RGB10A2_BITMAP = 2

static

Export HLG 10bit bitmap

CREATE_RETRIEVER_FLAG_PREFERENTIAL_USE_HARDWARE_READER

final int com.meicam.sdk.NvsVideoFrameRetriever.CREATE_RETRIEVER_FLAG_PREFERENTIAL_USE_HARDWARE_READER = 1

static

Preferential use hardware reader.

VIDEO_FRAME_HEIGHT_GRADE_360

final int com.meicam.sdk.NvsVideoFrameRetriever.VIDEO_FRAME_HEIGHT_GRADE_360 = 0

static

Video frame of 360 pixels in height.

VIDEO_FRAME_HEIGHT_GRADE_480

final int com.meicam.sdk.NvsVideoFrameRetriever.VIDEO_FRAME_HEIGHT_GRADE_480 = 1

static

Video frame of 480 pixels in height.

VIDEO_FRAME_HEIGHT_GRADE_720

final int com.meicam.sdk.NvsVideoFrameRetriever.VIDEO_FRAME_HEIGHT_GRADE_720 = 2

static

Video frame of 720 pixels in height

---

The documentation for this class was generated from the following file:

• src/android/jar/com/meicam/sdk/NvsVideoFrameRetriever.java