BNBEffectPlayer Class Reference

The EffectPlayer class provides ability to play AR effects on set of images or video. More...

#import <BNBEffectPlayer.h>

Inheritance diagram for BNBEffectPlayer:

Instance Methods
(void)	- addFrameDurationListener:
	Add callback to receive FPS information. More...
(void)	- removeFrameDurationListener:
	Remove callback to receive FPS information. More...
(void)	- addFaceNumberListener:
	Add callback to receive faces count in frame. More...
(void)	- removeFaceNumberListener:
	Remove callback to receive faces count in frame. More...
(void)	- addFrameDataListener:
	Add callback to receive frame data right after processing in recognizer. More...
(void)	- removeFrameDataListener:
	Remove callback to receive frame data right after processing in recognizer. More...
(void)	- addLowLightListener:
	Add callback to receive low light info Thread-safe. More...
(void)	- removeLowLightListener:
	Remove callback to receive low light info Thread-safe. More...
(void)	- addCameraPoiListener:
	Add callback to receive center of the face in frame relative to top-left corner in [0, 1] space. More...
(void)	- removeCameraPoiListener:
	Remove callback to receive center of the face in frame relative to top-left Thread-safe. More...
(void)	- addEffectInfoListener:
	Add callback to receive current effect info from Effect Player. More...
(void)	- removeEffectInfoListener:
	Remove callback to receive current effect info from Effect Player. More...
(void)	- addEffectActivationCompletionListener:
	Add callback to receive current effect activation notification from Effect Player. More...
(void)	- removeEffectActivationCompletionListener:
	Remove callback to receive current effect activation notification from Effect Player. More...
(void)	- setMaxFaces:
	Sets maximum allowed face results, if face tracking feature is present. More...
(void)	- setExternalCameraTexture:width:height:
	Set OpenGL name of input external texture. More...
(void)	- setUseExtCamTex:
	Use external texture as input source. More...
(void)	- surfaceCreated:height:
	Use to notify the EffectPlayer that the surface exists and effect can be played. More...
(void)	- surfaceChanged:height:
	Notify about rendering surface being resized. More...
(void)	- surfaceDestroyed
	This method should be called right before an active context will become invalid. More...
(int64_t)	- draw
	Draw the current effect into the current OpenGL framebuffer. More...
(int64_t)	- drawWithExternalFrameData:
	Draw the current effect into the current OpenGL framebuffer. More...
(void)	- captureBlit:captureHeight:
	Record last rendering ("draw_()") result into current OpenGL framebuffer. More...
(nonnull NSData *)	- readPixels:height:
	Receive the last rendered frame in binary form. More...
(void)	- setRenderConsistencyMode:
	Thread-safe. More...
(void)	- setRenderTransform:viewportRect:xFlip:yFlip:
	Request display of sub-area of the input image into sub-area of the output surface, with optional x,y flips imageRect is fitted inside viewportRect Resets transform to default if either rect has 0 dimensions. More...
(nonnull NSData *)	- processImage:outputPixelFormat:params:
	Process an image with current effect. More...
(nonnull NSData *)	- processImageFrameData:outputPixelFormat:params:
	Process an image with current effect. More...
(nonnull NSData *)	- processImageData:width:height:orientation:isMirrored:inputPixelFormat:outputPixelFormat:params:
	Process image with current effect. More...
(void)	- pushFrame:
	Provides image to process and to play effect. More...
(void)	- pushFrameWithNumber:frameNumber:
	Provides image to process and to play effect. More...
(void)	- pushFrameData:
	Provides FrameData to process and to play effect. More...
(void)	- playbackPlay
	MUST be called from the main(render) thread. More...
(void)	- playbackPause
(void)	- playbackStop
(BNBEffectPlayerPlaybackState)	- getPlaybackState
	Thread-safe. More...
(nullable BNBScene *)	- getCurrentScene
	If currently loaded effect is based on new Scene engine and it is loaded completly returns Scene object from the effect. More...
(void)	- setEffectVolume:
	Set effect audio volume. More...
(void)	- enableAudio:
	Set audio enabled. More...
(nullable BNBInputManager *)	- getInputManager
	Get interface to control user iterations. More...
(void)	- startVideoProcessing:screenHeight:orientation:resetEffect:offlineMode:
	Initialize video processing. More...
(void)	- stopVideoProcessing:
	Finish processing and return renderer to normal state. More...
(nullable BNBFrameData *)	- processVideoFrameData:params:recognizerIterations:
	Provide frame data to evaluate video processing. More...
(nullable BNBFrameData *)	- processVideoFrame:params:recognizerIterations:
	Provide frame to evaluate video processing. More...
(nonnull NSData *)	- drawVideoFrame:timeNs:outputPixelFormat:
	Draw processed frame to image buffer. More...
(nonnull NSData *)	- drawVideoFrameAllocated:timeNs:outputPixelFormat:allocatedBuffer:
	The same as draw_video_frame but accepts preallocated buffer to avoid recreation for every frame. More...
(BOOL)	- isVoiceChangerConfigured
	Thread-safe. More...
(void)	- processRecordedAudio:outFilename:mixVolume:
	Process recorded voice with voice changer effects mixing with recorded sounds. More...
(void)	- writeRecordedAudio:lengthMs:
	Save recorded audio. More...
(void)	- onVideoRecordStart:
	Trigger record start events in EP and Effect. More...
(void)	- onVideoRecordEnd
	Triggers record stop events in EP and Effect. More...
(BOOL)	- isDeviceNnCompatible
	Check is device compatible with Neural Networks player Thread-safe. More...
(void)	- startFramedataCapture:filename:
	Request to start framedata capture process. More...
(void)	- stopFramedataCapture
(void)	- startAnalyticsCapture:config:listener:
	Request to start analytics capture process. More...
(void)	- stopAnalyticsCapture
(nullable BNBEffectManager *)	- effectManager
	Get effect manager object Thread-safe. More...
(nullable BNBDebugInterface *)	- debugInterface
	For internal usage only. More...
(void)	- setRecognizerOfflineMode:
	Force recognizer offline mode Thread-safe. More...
(void)	- setFaceSearchMode:
	Change face search mode Thread-safe. More...

Class Methods
(nullable BNBEffectPlayer *)	+ create:
(int32_t)	+ versionMajor
	Get major version of EffectPlayer. More...
(int32_t)	+ versionMinor
	Get minor version of EffectPlayer. More...

Detailed Description

The EffectPlayer class provides ability to play AR effects on set of images or video.

Lifecycle

In order to support an application lifecycle EffectPlayer provides special methods to control it during application states like pause or losing focus.

Effect playback

Initial playback state of newly created Effect Player instance is active. With playback control methods described below, the player can be launched/resumed or paused. State of effect player becomes stopped/inactive at the moment of surface loss or by calling the EffectPlayer::playback_stop method. One can use next three methods to control effect playback:
- EffectPlayer.playback_play. Switching to active state attempt. Possible from paused or stopped state and has no effect if effect playback is already active. Playback resumes from the position saved before EffectPlayer.playbackPause call.
- EffectPlayer.playback_pause. Suspend current playback attempt. The recognizer thread is stopped and all the video textures and audio units playback is stopped as well. Effect player doesn't react on EffectPlayer::pushFrame calls in suspended state except asynchronous-inconsistent mode.
- EffectPlayer.playbackStop. Switch to inactive state. In addition to pause clears recognizer's buffer. The next switch to active state will result in total rerun of active effect which means that it will be started from the very beginning.

Android usage example

If you want an application to be active on windowed mode and if the focus is on another application you can switch EffectPlayer into active state when onStart activity callback occurs and switch to paused when onStop occurs. Otherwise you can suspend EffectPlayer on onPause and resume on onResume callback to make an instance of the EffectPlayer inactive while activity losing focus.

Context/surface control

There are two methods that have to be used to ensure correct operating of the EffectPlayer. Losing context without notifying the EffectPlayer leads to application crash. Methods for context changes notification:
- EffectPlayer.surfaceCreated
- EffectPlayer.surfaceDestroyed

Multi-Threading performance and safety. Listeners.

EffectPlayer allows to call some of its methods from several threads (simultaneously) for convenience and increased performance. This is allowed only during normal operation, all invocations from other threads MUST finish before you start destroying the EffectPlayer instance. Most methods belong to one of the two groups:
- MUST be called from the "Main" (also "Render") thread ("Not Reentrant, Not Thread-safe")
- MAY be called from "Any" thread. Most are "Thread-safe" Listener callbacks can be called back from any thread. Generally for best performance and responsiveness you'll have 3 threads:
- Main(render) thread for drawing-related operations
- "Camera" thread for handling and push()-ing frames into EffectPlayer
- UI Thread for handling user interactions and other tasks

Definition at line 77 of file BNBEffectPlayer.h.

Method Documentation

addCameraPoiListener:

- (void) addCameraPoiListener:

(nullable id< BNBCameraPoiListener >)

cameraPoiListener

Add callback to receive center of the face in frame relative to top-left corner in [0, 1] space.

Thread-safe. May be called from any thread

addEffectActivationCompletionListener:

- (void) addEffectActivationCompletionListener:

(nullable id< BNBEffectActivationCompletionListener >)

effectActivationCompletionListener

Add callback to receive current effect activation notification from Effect Player.

Thread-safe. May be called from any thread

addEffectInfoListener:

- (void) addEffectInfoListener:

(nullable id< BNBEffectInfoListener >)

effectInfoListener

Add callback to receive current effect info from Effect Player.

Thread-safe. May be called from any thread

addFaceNumberListener:

- (void) addFaceNumberListener:

(nullable id< BNBFaceNumberListener >)

faceNumberListener

Add callback to receive faces count in frame.

Thread-safe. May be called from any thread

addFrameDataListener:

- (void) addFrameDataListener:

(nullable id< BNBFrameDataListener >)

frameDataListener

Add callback to receive frame data right after processing in recognizer.

Thread-safe. May be called from any thread

addFrameDurationListener:

- (void) addFrameDurationListener:

(nullable id< BNBFrameDurationListener >)

frameDurationListener

Add callback to receive FPS information.

Thread-safe. May be called from any thread

addLowLightListener:

- (void) addLowLightListener:

(nullable id< BNBLowLightListener >)

lowLightListener

Add callback to receive low light info Thread-safe.

May be called from any thread

captureBlit:captureHeight:

- (void) captureBlit:		(int32_t)	captureWidth
captureHeight:		(int32_t)	captureHeight

Record last rendering ("draw_()") result into current OpenGL framebuffer.

Content is cropped to maintain effect_size() aspect ratio MUST be called from the render thread

create:

+ (nullable BNBEffectPlayer *) create:

(nonnull BNBEffectPlayerConfiguration *)

configuration

debugInterface

- (nullable BNBDebugInterface *) debugInterface

For internal usage only.

draw

- (int64_t) draw

Draw the current effect into the current OpenGL framebuffer.

Uses internal frame_data object obtained from latest push_frame recognition result.

Return current frame number if drawing was performed and caller should swap buffers otherwise DRAW_SKIPPED(-1) MUST be called from the render thread

drawVideoFrame:timeNs:outputPixelFormat:

- (nonnull NSData *) drawVideoFrame:		(nullable BNBFrameData *)	inputFrameData
timeNs:		(int64_t)	timeNs
outputPixelFormat:		(BNBPixelFormat)	outputPixelFormat

Draw processed frame to image buffer.

MUST be called from the render thread

Parameters

inputFrameData	FrameData to draw.
timeNs	Frame position on timeline.
outputPixelFormat	Output image format.

Returns

Buffer with processed image in selected format.

drawVideoFrameAllocated:timeNs:outputPixelFormat:allocatedBuffer:

- (nonnull NSData *) drawVideoFrameAllocated:		(nullable BNBFrameData *)	inputFrameData
timeNs:		(int64_t)	timeNs
outputPixelFormat:		(BNBPixelFormat)	outputPixelFormat
allocatedBuffer:		(nonnull NSData *)	allocatedBuffer

The same as draw_video_frame but accepts preallocated buffer to avoid recreation for every frame.

MUST be called from the render thread

drawWithExternalFrameData:

- (int64_t) drawWithExternalFrameData:

(nullable BNBFrameData *)

frameData

Draw the current effect into the current OpenGL framebuffer.

Uses externally provided frameData object instead of internal one obtained from latest push_frame recognition result.

Return frame number from provided frameData if drawing was performed and caller should swap buffers otherwise DRAW_SKIPPED(-1) MUST be called from the render thread

effectManager

- (nullable BNBEffectManager *) effectManager

Get effect manager object Thread-safe.

May be called from any thread

enableAudio:

- (void) enableAudio:

(BOOL)

enable

Set audio enabled.

getCurrentScene

- (nullable BNBScene *) getCurrentScene

If currently loaded effect is based on new Scene engine and it is loaded completly returns Scene object from the effect.

Otherwise returns null. MUST be called from the render thread Returned Scene object MUST be used only from the render thread and only while the effect is in the loaded state.

getInputManager

- (nullable BNBInputManager *) getInputManager

Get interface to control user iterations.

This events will be passed to effect. Thread-safe. May be called from any thread

getPlaybackState

- (BNBEffectPlayerPlaybackState) getPlaybackState

Thread-safe.

May be called from any thread

isDeviceNnCompatible

- (BOOL) isDeviceNnCompatible

Check is device compatible with Neural Networks player Thread-safe.

May be called from any thread On some platforms (e.g. Android) may require the first invocation to be on the render thread

isVoiceChangerConfigured

- (BOOL) isVoiceChangerConfigured

Thread-safe.

May be called from any thread

onVideoRecordEnd

- (void) onVideoRecordEnd

Triggers record stop events in EP and Effect.

Thread-safe. May be called from any thread

onVideoRecordStart:

- (void) onVideoRecordStart:

(BOOL)

playAudioWhileRecording

Trigger record start events in EP and Effect.

Records all sounds during recording to be replayed by processRecordedAudio. If

Parameters

playAudioWhileRecording

is true, the audio will continue to play. Otherwise, the audio will be muted. Thread-safe. May be called from any thread

playbackPause

- (void) playbackPause

playbackPlay

- (void) playbackPlay

MUST be called from the main(render) thread.

playbackStop

- (void) playbackStop

processImage:outputPixelFormat:params:

- (nonnull NSData *) processImage:		(nonnull BNBFullImageData *)	inputImage
outputPixelFormat:		(BNBPixelFormat)	outputPixelFormat
params:		(nonnull BNBProcessImageParams *)	params

Process an image with current effect.

Must be called from the render thread.

Parameters

inputImage	to avoid conversion recommended to use YUV image
outputPixelFormat	to avoid conversion recommended to use RGBA
params	extra image processing arguments

processImageData:width:height:orientation:isMirrored:inputPixelFormat:outputPixelFormat:params:

- (nonnull NSData *) processImageData:		(nonnull NSData *)	inputImage
width:		(int32_t)	width
height:		(int32_t)	height
orientation:		(BNBCameraOrientation)	orientation
isMirrored:		(BOOL)	isMirrored
inputPixelFormat:		(BNBPixelFormat)	inputPixelFormat
outputPixelFormat:		(BNBPixelFormat)	outputPixelFormat
params:		(nonnull BNBProcessImageParams *)	params

Process image with current effect.

Must be called from render thread. NOTE: inputImage have copy overhead, preferable to use process_image method MUST be called from the render thread

Parameters

inputImage	input image with width * height * 4 size
outputPixelFormat	to avoid conversion recommended to use RGBA

processImageFrameData:outputPixelFormat:params:

- (nonnull NSData *) processImageFrameData:		(nullable BNBFrameData *)	inputFrameData
outputPixelFormat:		(BNBPixelFormat)	outputPixelFormat
params:		(nonnull BNBProcessImageParams *)	params

Process an image with current effect.

Prefer this method over processImage when you have extra input data besides just an input image.

Must be called from render thread.

Parameters

inputFrameData	FrameData with an image
outputPixelFormat	to avoid conversion recommended to use RGBA
params	extra image processing arguments

processRecordedAudio:outFilename:mixVolume:

- (void) processRecordedAudio:		(nonnull NSString *)	inFilename
outFilename:		(nonnull NSString *)	outFilename
mixVolume:		(float)	mixVolume

Process recorded voice with voice changer effects mixing with recorded sounds.

Copies in->out if no voice changer or effect is active. Not thread-safe but can be called from any thread. Recorded sounds have the same lifetime as the effect(e.g reset after load_effect, etc.).

Parameters

inFilename	Input filename.
outFilename	Must have ".wav" extension.
mixVolume	Relative volume for mixing in sounds, [0..1].

processVideoFrame:params:recognizerIterations:

- (nullable BNBFrameData *) processVideoFrame:		(nonnull BNBFullImageData *)	inputImage
params:		(nonnull BNBProcessImageParams *)	params
recognizerIterations:		(nullable NSNumber *)	recognizerIterations

Provide frame to evaluate video processing.

MUST be called from the render thread

Parameters

inputImage	Image to process.
params	Processing params.
recognizerIterations	Number of processing iterations. Higher number means higher processing quality, but lower speed. Must be greater than 1. Pass null value for default number.

Returns

Frame data with frame processing results.

processVideoFrameData:params:recognizerIterations:

- (nullable BNBFrameData *) processVideoFrameData:		(nullable BNBFrameData *)	inputFrameData
params:		(nonnull BNBProcessImageParams *)	params
recognizerIterations:		(nullable NSNumber *)	recognizerIterations

Provide frame data to evaluate video processing.

MUST be called from the render thread

Parameters

inputFrameData	Frame Data to process.
params	Processing params.
recognizerIterations	Number of processing iterations. Higher number means higher processing quality, but lower speed. Must be greater than 1. Pass null value for default number.

Returns

Frame data with frame processing results.

pushFrame:

- (void) pushFrame:

(nonnull BNBFullImageData *)

fullImage

Provides image to process and to play effect.

Thread-safe. May be called from any thread

pushFrameData:

- (void) pushFrameData:

(nullable BNBFrameData *)

frameData

Provides FrameData to process and to play effect.

Must contain full image. Thread-safe. May be called from any thread

pushFrameWithNumber:frameNumber:

- (void) pushFrameWithNumber:		(nonnull BNBFullImageData *)	fullImage
frameNumber:		(int64_t)	frameNumber

Provides image to process and to play effect.

Thread-safe. May be called from any thread

readPixels:height:

- (nonnull NSData *) readPixels:		(int32_t)	width
height:		(int32_t)	height

Receive the last rendered frame in binary form.

Parameters

width	width of the picture to take, must match the values passed to setEffectSize or create
height	height of the picture to take, must match the values passed to setEffectSize or create

Returns

RGBA data, size is width * height * 4 MUST be called from the render thread

removeCameraPoiListener:

- (void) removeCameraPoiListener:

(nullable id< BNBCameraPoiListener >)

cameraPoiListener

Remove callback to receive center of the face in frame relative to top-left Thread-safe.

May be called from any thread

removeEffectActivationCompletionListener:

- (void) removeEffectActivationCompletionListener:

(nullable id< BNBEffectActivationCompletionListener >)

effectActivationCompletionListener

Remove callback to receive current effect activation notification from Effect Player.

Thread-safe. May be called from any thread

removeEffectInfoListener:

- (void) removeEffectInfoListener:

(nullable id< BNBEffectInfoListener >)

effectInfoListener

Remove callback to receive current effect info from Effect Player.

Thread-safe. May be called from any thread

removeFaceNumberListener:

- (void) removeFaceNumberListener:

(nullable id< BNBFaceNumberListener >)

faceNumberListener

Remove callback to receive faces count in frame.

Thread-safe. May be called from any thread

removeFrameDataListener:

- (void) removeFrameDataListener:

(nullable id< BNBFrameDataListener >)

frameDataListener

Remove callback to receive frame data right after processing in recognizer.

Thread-safe. May be called from any thread

removeFrameDurationListener:

- (void) removeFrameDurationListener:

(nullable id< BNBFrameDurationListener >)

frameDurationListener

Remove callback to receive FPS information.

Thread-safe. May be called from any thread

removeLowLightListener:

- (void) removeLowLightListener:

(nullable id< BNBLowLightListener >)

lowLightListener

Remove callback to receive low light info Thread-safe.

May be called from any thread

setEffectVolume:

- (void) setEffectVolume:

(float)

volume

Set effect audio volume.

Thread-safe. May be called from any thread

Parameters

volume

A value in range [0, 1], where 1 means maximum volume.

setExternalCameraTexture:width:height:

- (void) setExternalCameraTexture:		(int32_t)	name
width:		(int32_t)	width
height:		(int32_t)	height

Set OpenGL name of input external texture.

https://developer.android.com/reference/android/graphics/SurfaceTexture . MUST be called from the render thread

Parameters

name	Texture name
width	Textute width
height	Texture height

See also

setUseExtCamTex

Note: This function is Android only.
Note: We use texture size to calculate aspect ratio only.

setFaceSearchMode:

- (void) setFaceSearchMode:

(BNBFaceSearchMode)

faceSearch

Change face search mode Thread-safe.

May be called from any thread

setMaxFaces:

- (void) setMaxFaces:

(int32_t)

maxFaces

Sets maximum allowed face results, if face tracking feature is present.

Thread-safe. May be called from any thread This option is relevant only for GLFX effects.

setRecognizerOfflineMode:

- (void) setRecognizerOfflineMode:

(BOOL)

on

Force recognizer offline mode Thread-safe.

May be called from any thread

setRenderConsistencyMode:

- (void) setRenderConsistencyMode:

(BNBConsistencyMode)

value

Thread-safe.

May be called from any thread

setRenderTransform:viewportRect:xFlip:yFlip:

- (void) setRenderTransform:		(nonnull BNBPixelRect *)	imageRect
viewportRect:		(nonnull BNBPixelRect *)	viewportRect
xFlip:		(BOOL)	xFlip
yFlip:		(BOOL)	yFlip

Request display of sub-area of the input image into sub-area of the output surface, with optional x,y flips imageRect is fitted inside viewportRect Resets transform to default if either rect has 0 dimensions.

Parameters

imageRect	rectangle in input image coordinates(pixels) after applying input rotations and flips
viewportRect	rectangle in output surface coordinates(pixels) MUST be called from the render thread

setUseExtCamTex:

- (void) setUseExtCamTex:

(BOOL)

value

Use external texture as input source.

MUST be called from the render thread

See also

setExternalCameraTexture

Note

This function is Android only

startAnalyticsCapture:config:listener:

- (void) startAnalyticsCapture:		(nonnull NSDictionary< NSString *, NSString * > *)	deviceInfo
config:		(nonnull BNBAnalyticsConfig *)	config
listener:		(nullable id< BNBAnalyticsListener >)	listener

Request to start analytics capture process.

Analytics supports two business cases:

1. Capture high resolution photo with face (bigger than 720p).
2. Capture N frames with face (N is configurable, if N=0 capturer will skip this case). Result is a path to CBOR file with images and face recognition results, compressed with zlib. Thread-safe. May be called from any thread

   Parameters

   deviceInfo	Any user specific information to attach in analytics report.
   config	Setup configurable properties (like frames counter and delay before capture).
   listener	Callback which is fired in one of two above mentioned cases.

startFramedataCapture:filename:

- (void) startFramedataCapture:		(nonnull NSString *)	folder
filename:		(nullable NSString *)	filename

Request to start framedata capture process.

Output file is in CBOR format. Thread-safe. May be called from any thread

Parameters

folder	Output folder.
filename	Output filename. If the value is an empty string, filename is generated based on date and time.

startVideoProcessing:screenHeight:orientation:resetEffect:offlineMode:

- (void) startVideoProcessing:		(int64_t)	screenWidth
screenHeight:		(int64_t)	screenHeight
orientation:		(BNBCameraOrientation)	orientation
resetEffect:		(BOOL)	resetEffect
offlineMode:		(BOOL)	offlineMode

Initialize video processing.

To provide frames use process_video_frame methods. Effect audio is recorded as well and can be accessed using process_recorded_audio and write_recorded_audio. push_frame should not be called during processing. MUST be called from the render thread

Exceptions

Exception

Must be aborted with stop_video_processing()

stopAnalyticsCapture

- (void) stopAnalyticsCapture

stopFramedataCapture

- (void) stopFramedataCapture

See also

startFramedataCapture

stopVideoProcessing:

- (void) stopVideoProcessing:

(BOOL)

resetEffect

Finish processing and return renderer to normal state.

MUST be called from the render thread

surfaceChanged:height:

- (void) surfaceChanged:		(int32_t)	width
height:		(int32_t)	height

Notify about rendering surface being resized.

MUST be called from the render thread

surfaceCreated:height:

- (void) surfaceCreated:		(int32_t)	width
height:		(int32_t)	height

Use to notify the EffectPlayer that the surface exists and effect can be played.

0, 0 for width and height are valid values. MUST be called from the render thread

surfaceDestroyed

- (void) surfaceDestroyed

This method should be called right before an active context will become invalid.

Switches playback state to inactive state. If it's not done an application will be crashed on next draw iteration. After losing the surface effect playback can't be resumed from last position. MUST be called from the render thread

versionMajor

+ (int32_t) versionMajor

Get major version of EffectPlayer.

Use this method to filter out breaking changes in implementation of this class.

Note

this is not version of SDK.

See also

EffectPlayer.versionMinor

versionMinor

+ (int32_t) versionMinor

Get minor version of EffectPlayer.

See also

EffectPlayer.versionMajor

writeRecordedAudio:lengthMs:

- (void) writeRecordedAudio:		(nonnull NSString *)	filename
lengthMs:		(int64_t)	lengthMs

Save recorded audio.

Not thread-safe but can be called from any thread.

Parameters

filename	".wav" extension must be used.
lengthMs	Track length. Set to '0' to use full duration.

---

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

• BNBEffectPlayer.h