Welcome Apps REST API

What's new in V16?

AI Moderation Labeling
In-Asset Commenting
Improved Search
React Component + NPM
Video Only Mode
Mobile Zoom Level Selection
Camera / Mic Obstruction Events
Speed Improvements
Split Libraries
Updated Playback and Recording Signatures
New Storage Modes & Pricing


AI Moderation Labeling

Moderation labels are now one of the available outputs in your app's processing settings. Adding a moderation label output will have our AI analyze your video and label (with timestamps) any content that may be objectionalble to a general viewing adiendce (nudity, violence, drug use etc). You can learn more in the docs

In-Asset Commenting

You can now add in-line comments when viewing an asset in the CameraTag Player. This feature is enabled for all logged in users on CameraTag.com and can be enabled for CameraTag players embeded in your own products as well. Learn more in the docs

New NPM Modules and React Components

We have introduced 12 new packages to the NPM to make including CameraTag in your product even easier.

Product URL Package Name
<camera> https://www.npmjs.com/package/@cameratag/camera @cameratag/camera
<microphone> https://www.npmjs.com/package/@cameratag/microphone @cameratag/microphone
<photobooth> https://www.npmjs.com/package/@cameratag/photobooth @cameratag/photobooth
<player> https://www.npmjs.com/package/@cameratag/player @cameratag/player
<wall> https://www.npmjs.com/package/@cameratag/wall @cameratag/wall
<photo> https://www.npmjs.com/package/@cameratag/photo @cameratag/photo
React <camera> https://www.npmjs.com/package/@cameratag/react_camera @cameratag/react_camera
React <microphone> https://www.npmjs.com/package/@cameratag/react_microphone @cameratag/react_microphone
React <photobooth> https://www.npmjs.com/package/@cameratag/react_photobooth @cameratag/react_photobooth
React <player> https://www.npmjs.com/package/@cameratag/react_player @cameratag/react_player
React <wall> https://www.npmjs.com/package/@cameratag/react_wall @cameratag/react_wall
React <photo> https://www.npmjs.com/package/@cameratag/react_photo @cameratag/react_photo

Camera / Mic Obstruction Events

The <camera> and <microphone> tags now fire events when the camera or microphone is obstructed by a physical security device such as a webcam cover or a finger.

The <camera> tag will fire the "cameraReady" and "cameraNotReady" events when the camera is in an unobstructed or obstructed state respectively.

The <microphone> tag will fire the "micReady" and "micNotReady" events when the microphone is in an unobstructed or obstructed state respectively.

You can learn more in the docs

Mobile Zoom Level Selection

You can now select the zoom level for your mobile devices. This is as simple as adding the data-zoomLevel=XXX attribute to your <camera> tag.

You can learn more in the docs

Video Only Mode

You can now opt to record only video (no audio) in your <camaera>. This is as simple as adding the data-videoOnly="true" attribute to your <camera> tag.

You can learn more in the docs

Updated Signatures

If you use recording and/or playback signatures to increase the security of your CameraTag products you will need to update your signatures when upgrading to v16. You can read all about the new signature process in the app signature docs

Splitting The CameraTag Products

We have traditionally bundled all of the CameraTag embeds (camera, microphone, photobooth, player, wall, photo) into a single JS file which contained a single JS Class named CameraTag. The time has come to give each product its own JS file and its own JS Class. Starting with v16 each CameraTag embed can be loaded separately. This will slightly change the JS API: moving class methods (such as setup, fire, observe) from the previous monolithic CameraTag class into the new product specific classes. Below is a before and after example of some simple code to load a <camera> and then fire an alert once it's initialized.

BEFORE:

<script src='//www.cameratag.com/v16/js/cameratag.js' type='text/javascript'></script>
<link rel='stylesheet' href='//www.cameratag.com/v16/css/cameratag.css'></link>

<camera id="myCamera" data-uuid="[YOUR_APP_UUID]"/>

<script>
  CameraTag.observe("myCamera", "initilized", function(){
    alert("initialized!")
  })
</script>

NOW:
(Note the change of the JS URL from cameratag.js to camera.js and the change of the JS class from CameraTag to CameraTagCamera:)

<script src='//www.cameratag.com/v16/js/camera.js' type='text/javascript'></script>
<link rel='stylesheet' href='//www.cameratag.com/v16/css/cameratag.css'></link>

<camera id="myCamera" data-uuid="[YOUR_APP_UUID]"/>

<script>
  CameraTagCamera.observe("myCamera", "initilized", function(){
    alert("initialized!")
  })
</script>

Below is a table that outlines the new URL and Class name for each of the CameraTag embeds. for any of the products to see what the new embed codes look like for you.

Prodct JS URL JS Class Name
<camera> //www.cameratag.com/v16/js/camera.js CameraTagCamera
<microphone> //www.cameratag.com/v16/js/microphone.js CameraTagMicrophone
<photobooth> //www.cameratag.com/v16/js/photobooth.js CameraTagPhotobooth
<player> //www.cameratag.com/v16/js/player.js CameraTagPlayer
<wall> //www.cameratag.com/v16/js/wall.js CameraTagWall
<photo> //www.cameratag.com/v16/js/photo.js CameraTagPhoto

New Storage Modes & Pricing

To accompany our new storage pricing model we have introduced two new storage modes: "No Storage" and "Free Only". The "No Storage" mode will immediatly remove assets from CameraTag once they have been processed (transcoded, stored and notified). The "Free Only" mode will remove assets fromCameraTag after their free storage period (see your plan details) has expired.

You can learn more on the pricing page here