Class Player

isPlaying

• get isPlaying(): boolean

• Returns boolean

addEventListener

• addEventListener<E>(event, listener, options?): void

• Type Parameters

  • E extends EventKey<PlayerEventMap>

  Parameters

  • event: E

  • listener: EventListener<PlayerEventMap[E]>

  • Optional options: boolean | AddEventListenerOptions

  Returns void

addModule

• addModule(...modules): Promise<void>

• Adds additional modules like face_tracker, background and many others to the Player and makes them available for effects

  Parameters

  • Rest ...modules: Module[]

  Returns Promise<void>

  Example

  const frx = new Module("/path/to/face_tracker.zip")
  
  await player.addModule(frx)
  Copy

applyEffect

• applyEffect(effect): Promise<BanubaSDK.Effect>

• Applies an effect to input

  Parameters

  • effect: Effect

  Returns Promise<BanubaSDK.Effect>

  Example

  const octopus = new Effect("/path/to/Octopus.zip")
  
  await player.applyEffect(octopus)
  Copy

callJsMethod

• callJsMethod(methodName, methodJSONParams?): Promise<void>

• Evaluates JavaScript in context of applied effect.

  Parameters

  • methodName: string

  • methodJSONParams: string = ""

  Returns Promise<void>

  Deprecated

  Use evalJs instead.

clearEffect

• clearEffect(): Promise<void>

• Clears effect applied to input

  Returns Promise<void>

destroy

• destroy(): Promise<void>

• Destroys the Player instance, clears all the resources used

  Returns Promise<void>

pause

• pause(): void

• Stops input processing

  Returns void

play

• play(options?): void

• Starts input processing.

  Accepts playback options object with optional fps and pauseOnEmpty keys.

  Parameters

  • options: PlaybackOptions = {}

  Returns void

  Example

  /// The `fps` playback option persists between invocations:
  
  const desiredFps = 25
  
  player.play({ fps: desiredFps })
  player.play() // same as passing `{ fps: desiredFps }`
  Copy

  Example

  /// The `pauseOnEmpty` playback option resets to `true` between invocations:
  
  await player.use(new Image(file))
  player.applyEffect(new Effect("path/to/Spider.zip")) // an effect with animations
  
  player.play({ pauseOnEmpty: false })
  player.play() // same as passing `{ pauseOnEmpty: true }`
  Copy

removeEventListener

• removeEventListener<E>(event, listener, options?): void

• Type Parameters

  • E extends EventKey<PlayerEventMap>

  Parameters

  • event: E

  • listener: EventListener<PlayerEventMap[E]>

  • Optional options: boolean | EventListenerOptions

  Returns void

setVolume

• setVolume(level): void

• Sets effect volume from 0 to 1

  Parameters

  • level: number

  Returns void

use

• use(input, options?): void

• Uses the input as frames source

  Parameters

  • input: Input

  • Optional options: InputOptions

  Returns void

  Example

  player.use(new Webcam())
  Copy

Static create

• create(options): Promise<Player>

• Creates Player instance.

  See SDKOptions and PlayerOptions for all the possible parameters.

  Parameters

  • options: SDKOptions & PlayerOptions

  Returns Promise<Player>

  Example

  const player = await Player.create({ clientToken: "xxx-xxx-xxx", devicePixelRatio: 1 })
  Copy

Static Readonly EFFECT_ACTIVATED_EVENT

Static Readonly FRAME_DATA_EVENT

player.addEventListener("framedata", ({ detail: frameData }) => {
  const hasFace = frameData.get("frxRecognitionResult.faces.0.hasFace")
  if (!hasFace) return

  const landmarks = frameData.get("frxRecognitionResult.faces.0.landmarks")
  console.log(landmarks)
})
Copy

Static Readonly FRAME_PROCESSED_EVENT

Static Readonly FRAME_RECEIVED_EVENT

Static Readonly FRAME_RENDERED_EVENT