@platform android
@hidden for internal use only
@detail api
@author zhushufan.ref
@brief Sets the video effects resource finder path and initializes video effects.
@param finder ResourceFinder path
@param deleter ResourceDeleter path
@return
- 0: Success.
- –1000: The Effects SDK is not integrated.
- –1001: This API is unavailable for your Effects SDK.
- –1002: Your Effects SDK's version is incompatible.
- < 0: Other error. See error code table for specific instructions.
@hidden for internal use only
@detail api
@author zhushufan.ref
@brief Appends video effects material package.
@param effectNodes Array of effect material package paths.
@return
- 0: Success.
- –1000: The Effects SDK is not integrated.
- –1001: This API is unavailable for your Effects SDK.
- –1002: Your Effects SDK's version is incompatible.
- < 0: Other error. See error code table for specific instructions.
@note This API adds new video effect to the video effect you set with setEffectNodes{@link #IVideoEffect#setEffectNodes}.
@hidden for internal use only
@detail api
@author zhushufan.ref
@brief Private method
Set video sticker effects material package.
@param effectNodes Array of effect material package paths.
@return
- 0: Success
- <0: Other errors
@detail api
@author wangjunlin.3182
@brief Stops face detection.
@return
- 0: Success.
- –1000: The Effects SDK is not integrated.
- –1001: This API is unavailable for your Effects SDK.
- –1002: Your Effects SDK's version is incompatible.
- < 0: Other error. See error code table for specific instructions.
@detail api
@author zhushufan.ref
@brief Disables video effects.
@return
- 0: Success.
- –1000: The Effects SDK is not integrated.
- –1001: This API is unavailable for your Effects SDK.
- –1002: Your Effects SDK's version is incompatible.
- < 0: Other error. See error code table for specific instructions.
@note Call enableVideoEffect{@link #IVideoEffect#enableVideoEffect} to enable video effects.
@detail api
@author wangjunlin.3182
@brief Turns off the virtual background.
@return
- 0: Success.
- –1000: The Effects SDK is not integrated.
- –1001: This API is unavailable for your Effects SDK.
- –1002: Your Effects SDK's version is incompatible.
- < 0: Other error. See error code table for specific instructions.
@note After calling enableVirtualBackground{@link #IVideoEffect#enableVirtualBackground} to enable the virtual background function, you can call this API to turn it off.
@detail api
@author wangjunlin.3182
@brief Starts face detection and registers the observer for the result.
With this observer, you will receive onFaceDetectResult{@link #IFaceDetectionObserver#onFaceDetectResult} periodically.
@param observer See IFaceDetectionObserver{@link #IFaceDetectionObserver}.
@param intervalMs The minimum time interval between two callbacks in milliseconds. The value should be greater than 0. The actual time interval is between interval_ms and interval_ms+the time slot of a captured video frame.
@param faceModelPath The absolute path of the face detection algorithm file. Typically it is the tt_face_vXXX.model file in the ttfacemodel folder.
@return
- 0: Success.
- –1000: The Effects SDK is not integrated.
- –1001: This API is unavailable for your Effects SDK.
- –1002: Your Effects SDK's version is incompatible.
- -1004: Initializing. This function will be available when the initialization is completed.
- < 0: Other error. See error code table for specific instructions.
@detail api
@author zhushufan.ref
@brief Enables video effects including beauty and color filters.
@return
- 0: Success.
- –1000: The Effects SDK is not integrated.
- –1001: This API is unavailable for your Effects SDK.
- –1002: Your Effects SDK's version is incompatible.
- < 0: Other error. See error code table for specific instructions.
@note
- You must call initCVResource{@link #IVideoEffect#initCVResource} before calling this API.
- This API does not turn on video effects directly, you must call setEffectNodes{@link #IVideoEffect#setEffectNodes} or setColorFilter{@link #IVideoEffect#setColorFilter} next.
- Call disableVideoEffect{@link #IVideoEffect#disableVideoEffect} to turn off video effects.
@detail api
@author zhushufan.ref
@brief Sets the original background to a specified image or a solid color.
@param backgroundStickerRes The absolute path of virtual background effects.
@param source Virtual background source. See VirtualBackgroundSource{@link #VirtualBackgroundSource}.
@return
- 0: Success.
- –1000: The Effects SDK is not integrated.
- –1001: This API is unavailable for your Effects SDK.
- –1002: Your Effects SDK's version is incompatible.
- < 0: Other error. See error code table for specific instructions.
@note
- You must call initCVResource{@link #IVideoEffect#initCVResource} before calling this API.
- Call disableVirtualBackground{@link #IVideoEffect#disableVirtualBackground} to turn off the virtual background.
@detail api
@author zhushufan.ref
@brief Checks video effect license, sets the video effect resource model path, and initializes video effect.
@param licenseFile The absolute path of the license file for authorization.
@param algoModelDir The absolute path of the Effects SDK's models file.
@return
- 0: Success.
- –1000: The Effects SDK is not integrated.
- –1002: Your Effects SDK's version is incompatible.
- < 0: Other error. See error code table for specific instructions.
@note When validating the license, the difference of the timestamp of the CV server and the timestamp of the client is checked. You must not change the time of the client.
@platform ios
@hidden for internal use only
@detail api
@author zhushufan.ref
@brief Sets the configuration for video effects expression detection.
@param config Expression detection configuration. See ByteRTCExpressionDetectConfig{@link #ByteRTCExpressionDetectConfig}.
@return
- 0: Success.
- –1000: The Effects SDK is not integrated.
- –1001: This API is unavailable for your Effects SDK.
- –1002: Your Effects SDK's version is incompatible.
- < 0: Other error. See error code table for specific instructions.
@hidden for internal use only
@detail api
@author zhushufan.ref
@brief Removes the designated video effects material package.
@param effectNodes Array of effect material package paths.
@return
- 0: Success.
- –1000: The Effects SDK is not integrated.
- –1001: This API is unavailable for your Effects SDK.
- –1002: Your Effects SDK's version is incompatible.
- < 0: Other error. See error code table for specific instructions.
@note Removes the designated video effects in setEffectNodes{@link #IVideoEffect#setEffectNodes} or appendEffectNodes{@link #IVideoEffect#appendEffectNodes}.
@detail api
@author zhushufan.ref
@brief Sets the color filter.
@param filterRes Filter effects package absolute path.
@return
- 0: Success.
- –1000: The Effects SDK is not integrated.
- –1001: This API is unavailable for your Effects SDK.
- –1002: Your Effects SDK's version is incompatible.
- < 0: Other error. See error code table for specific instructions.
@note Call setColorFilterIntensity{@link #IVideoEffect#setColorFilterIntensity} to set the intensity of the color filter enabled. Set the intensity to 0 to turn off color filter.
@detail api
@author zhushufan.ref
@brief Sets the intensity of the color filter enabled.
@param intensity Filter intensity. The value range 0,1 is set to be invalid when the range is exceeded.
Set the intensity to 0 to turn off color filter.
@return
- 0: Success.
- –1000: The Effects SDK is not integrated.
- –1001: This API is unavailable for your Effects SDK.
- –1002: Your Effects SDK's version is incompatible.
- < 0: Other error. See error code table for specific instructions.
@detail api
@author zhushufan.ref
@brief Sets the video effects material package.
@param effectNodes Array of effect material package paths.
To remove the current video effect, set it to null.
@return
- 0: Success.
- –1000: The Effects SDK is not integrated.
- –1001: This API is unavailable for your Effects SDK.
- –1002: Your Effects SDK's version is incompatible.
- < 0: Other error. See error code table for specific instructions.
@note You must call enableVideoEffect{@link #IVideoEffect#enableVideoEffect} before calling this API.
@detail api
@author zhushufan.ref
@brief Sets the intensity of video effects.
@param effectNode The absolute path of the effects resource package, see Resource Package Structure.
@param key The name of the material key to be set, see Functions of Resource Keys for the value.
@param value The intensity value that needs to be set, the value range 0,1, and the setting is invalid when it exceeds the range.
@return
- 0: Success.
- –1000: The Effects SDK is not integrated.
- –1001: This API is unavailable for your Effects SDK.
- –1002: Your Effects SDK's version is incompatible.
- < 0: Other error. See error code table for specific instructions.