Documentation

These events are specific to individual recorders or players.

  • Ziggeo's SDK raises events in real time
  • Simply prepare code to run at requested times
  • No need to monitor or institute checks for particular occurrences
  • Data parameter provided for all events
    • Includes all parameters set in embeddings
    • Videos themselves
    • Option to stream as sub-objects
  • Parameters of events depending on the particular event
  • If you need to obtain additional data from the embedding, you can use the embedding.get function, i.e.: embedding.get('video')

Access recorder embedding

var element = document.getElementById('elementID');
var embedding = ZiggeoApi.V2.Recorder.findByElement(element);

Access player embedding

var element = document.getElementById('elementID');
var embedding = ZiggeoApi.V2.Player.findByElement(element);
  1. Recorder events
  2. submitted

    Triggered when a video has been uploaded / recorded and processed

    ZiggeoApi.Events.on("submitted", function ( data ) {
    	//Your code goes here
    });
    embedding.on("submitted", function () {
    	//Your code goes here
    });
  3. manually_submitted

    Triggered when a video has been manually submitted

    ZiggeoApi.Events.on("manually_submitted", function ( data ) {
    	//Your code goes here
    });
    embedding.on("manually_submitted", function () {
    	//Your code goes here
    });
  4. uploaded

    Triggered when a video has been uploaded / recorded (but not processed)

    ZiggeoApi.Events.on("uploaded", function ( data ) {
    	//Your code goes here
    });
    embedding.on("uploaded", function () {
    	//Your code goes here
    });
  5. upload_selected

    Triggered when a file has been selected for upload

    ZiggeoApi.Events.on("upload_selected", function ( file, data ) {
    	//Your code goes here
    });
    embedding.on("upload_selected", function ( file ) {
    	//Your code goes here
    });
  6. recording

    Triggered when a recording process has started

    ZiggeoApi.Events.on("recording", function ( data ) {
    	//Your code goes here
    });
    embedding.on("recording", function () {
    	//Your code goes here
    });
  7. uploading

    Triggered when a video is uploading

    ZiggeoApi.Events.on("uploading", function ( data ) {
    	//Your code goes here
    });
    embedding.on("uploading", function () {
    	//Your code goes here
    });
  8. finished

    Triggered when a recording process has finished

    ZiggeoApi.Events.on("finished", function ( data ) {
    	//Your code goes here
    });
    embedding.on("finished", function () {
    	//Your code goes here
    });
  9. error_recorder

    Triggered when a video recorder encounters an error

    ZiggeoApi.Events.on("error_recorder", function ( data, error ) {
    	//Your code goes here
    });
    embedding.on("error_recorder", function ( error ) {
    	//Your code goes here
    });
  10. countdown

    Triggered while a video recorder counts down

    ZiggeoApi.Events.on("countdown", function ( time, data ) {
    	//Your code goes here
    });
    embedding.on("countdown", function ( time ) {
    	//Your code goes here
    });
  11. elapsed

    Recording Progress

    ZiggeoApi.Events.on("elapsed", function ( time, data ) {
    	//Your code goes here
    });
    embedding.on("elapsed", function ( time ) {
    	//Your code goes here
    });
  12. recording_progress

    Recording Progress

    ZiggeoApi.Events.on("recording_progress", function ( time ) {
    	//Your code goes here
    });
    embedding.on("recording_progress", function ( time ) {
    	//Your code goes here
    });
  13. upload_progress

    Upload Progress

    ZiggeoApi.Events.on("upload_progress", function ( uploaded, total, data ) {
    	//Your code goes here
    });
    embedding.on("upload_progress", function ( uploaded, total ) {
    	//Your code goes here
    });
  14. processing_progress

    Processing Progress

    ZiggeoApi.Events.on("processing_progress", function ( percentage, data ) {
    	//Your code goes here
    });
    embedding.on("processing_progress", function ( percentage ) {
    	//Your code goes here
    });
  15. processing

    Processing Progress

    ZiggeoApi.Events.on("processing", function ( percentage ) {
    	//Your code goes here
    });
    embedding.on("processing", function ( percentage ) {
    	//Your code goes here
    });
  16. processed

    Processing completed

    ZiggeoApi.Events.on("processed", function (  ) {
    	//Your code goes here
    });
    embedding.on("processed", function () {
    	//Your code goes here
    });
  17. ready_to_record

    Triggered when a video recorder is ready to record a video

    ZiggeoApi.Events.on("ready_to_record", function ( data ) {
    	//Your code goes here
    });
    embedding.on("ready_to_record", function () {
    	//Your code goes here
    });
  18. access_forbidden

    Triggered when access to camera is not granted

    ZiggeoApi.Events.on("access_forbidden", function ( data, error ) {
    	//Your code goes here
    });
    embedding.on("access_forbidden", function ( error ) {
    	//Your code goes here
    });
  19. access_granted

    Triggered when access to camera is granted

    ZiggeoApi.Events.on("access_granted", function ( data ) {
    	//Your code goes here
    });
    embedding.on("access_granted", function () {
    	//Your code goes here
    });
  20. access_revoked

    Triggered when access to camera is not granted

    ZiggeoApi.Events.on("access_revoked", function ( data ) {
    	//Your code goes here
    });
    embedding.on("access_revoked", function () {
    	//Your code goes here
    });
  21. camera_unresponsive

    Triggered when camera has become unresponsive.

    ZiggeoApi.Events.on("camera_unresponsive", function ( data ) {
    	//Your code goes here
    });
    embedding.on("camera_unresponsive", function () {
    	//Your code goes here
    });
  22. camera_nosignal

    Triggered when camera has no signal.

    ZiggeoApi.Events.on("camera_nosignal", function ( data ) {
    	//Your code goes here
    });
    embedding.on("camera_nosignal", function () {
    	//Your code goes here
    });
  23. verified

    Triggered after video is uploaded and verified that it can be processed.

    ZiggeoApi.Events.on("verified", function ( data ) {
    	//Your code goes here
    });
    embedding.on("verified", function () {
    	//Your code goes here
    });
  24. camerahealth

    Triggered when camera health changes.

    ZiggeoApi.Events.on("camerahealth", function ( healthy ) {
    	//Your code goes here
    });
    embedding.on("camerahealth", function ( healthy ) {
    	//Your code goes here
    });
  25. microphonehealth

    Triggered when microphone health changes.

    ZiggeoApi.Events.on("microphonehealth", function ( healthy ) {
    	//Your code goes here
    });
    embedding.on("microphonehealth", function ( healthy ) {
    	//Your code goes here
    });
  26. no_camera

    Triggered when no camera has been detected.

    ZiggeoApi.Events.on("no_camera", function ( data ) {
    	//Your code goes here
    });
    embedding.on("no_camera", function () {
    	//Your code goes here
    });
  27. no_microphone

    Triggered when no microphone has been detected.

    ZiggeoApi.Events.on("no_microphone", function ( data ) {
    	//Your code goes here
    });
    embedding.on("no_microphone", function () {
    	//Your code goes here
    });
  28. has_camera

    Triggered when a camera has been detected.

    ZiggeoApi.Events.on("has_camera", function ( data ) {
    	//Your code goes here
    });
    embedding.on("has_camera", function () {
    	//Your code goes here
    });
  29. has_microphone

    Triggered when a microphone has been detected.

    ZiggeoApi.Events.on("has_microphone", function ( data ) {
    	//Your code goes here
    });
    embedding.on("has_microphone", function () {
    	//Your code goes here
    });
  1. Player events
  2. play

    Triggered when a video is playing

    ZiggeoApi.Events.on("play", function ( data ) {
    	//Your code goes here
    });
    embedding.on("play", function () {
    	//Your code goes here
    });
  3. playing

    Fires after each play action is triggered (even if paused and then played, or if a seek operation is done)

    ZiggeoApi.Events.on("playing", function (  ) {
    	//Your code goes here
    });
    embedding.on("playing", function () {
    	//Your code goes here
    });
  4. pause

    Triggered when a playing video is paused

    ZiggeoApi.Events.on("pause", function ( data ) {
    	//Your code goes here
    });
    embedding.on("pause", function () {
    	//Your code goes here
    });
  5. paused

    Fires when the pause button is clicked

    ZiggeoApi.Events.on("paused", function (  ) {
    	//Your code goes here
    });
    embedding.on("paused", function () {
    	//Your code goes here
    });
  6. ended

    Fires when a video has ended

    ZiggeoApi.Events.on("ended", function (  ) {
    	//Your code goes here
    });
    embedding.on("ended", function () {
    	//Your code goes here
    });
  7. stop

    Triggered when a playing video is stopped

    ZiggeoApi.Events.on("stop", function ( data ) {
    	//Your code goes here
    });
    embedding.on("stop", function () {
    	//Your code goes here
    });
  8. error_player

    Triggered when the video player encounters an error

    ZiggeoApi.Events.on("error_player", function ( data, error ) {
    	//Your code goes here
    });
    embedding.on("error_player", function ( error ) {
    	//Your code goes here
    });
  9. seek

    Triggered when the user moves the progress indicator to continue video playback from a different position

    ZiggeoApi.Events.on("seek", function ( position ) {
    	//Your code goes here
    });
    embedding.on("seek", function ( position ) {
    	//Your code goes here
    });
  10. ready_to_play

    Triggered when a video player is ready to play a video

    ZiggeoApi.Events.on("ready_to_play", function ( data ) {
    	//Your code goes here
    });
    embedding.on("ready_to_play", function () {
    	//Your code goes here
    });
  1. Events that can happen on both player and recorder embedding
  2. attached

    Fires when the embedding is attached to the DOM element

    ZiggeoApi.Events.on("attached", function (  ) {
    	//Your code goes here
    });
    embedding.on("attached", function () {
    	//Your code goes here
    });
  3. loaded

    Triggered when the player / recorder is loaded for the first time

    ZiggeoApi.Events.on("loaded", function (  ) {
    	//Your code goes here
    });
    embedding.on("loaded", function () {
    	//Your code goes here
    });
  4. error

    Triggered when an embedding encounters an error

    ZiggeoApi.Events.on("error", function ( error ) {
    	//Your code goes here
    });
    embedding.on("error", function ( error ) {
    	//Your code goes here
    });
  5. rerecord

    Triggered when a recorded video is discarded and is being re-recorded

    ZiggeoApi.Events.on("rerecord", function (  ) {
    	//Your code goes here
    });
    embedding.on("rerecord", function () {
    	//Your code goes here
    });
  6. discarded

    Triggered when a recorded video is discarded and is being re-recorded

    ZiggeoApi.Events.on("discarded", function ( data ) {
    	//Your code goes here
    });
    embedding.on("discarded", function () {
    	//Your code goes here
    });
  7. flash_hibernate

    Triggered when browser puts Flash into hibernation mode

    ZiggeoApi.Events.on("flash_hibernate", function ( data ) {
    	//Your code goes here
    });
    embedding.on("flash_hibernate", function () {
    	//Your code goes here
    });