Camera Tag: Video Recording API & More!

Intro

Overview New in V15

Apps

Overview Configuration

Overview Embedding Configuration Custom Interface JS Methods JS Events Collecting Videos

Overview Embedding Configuration Custom Interface JS Methods JS Events

Overview Embedding Configuration Custom Interface JS Methods JS Events Collecting Audio

<room>

Overview Embedding Configuration Custom Interface JS Methods JS Events

Overview Embedding Configuration JS Methods & Events

<wall>

Overview Embedding Configuration JS Methods

<photo>

Overview Embedding

REST API

Overview List Assets Show Asset Update Asset Delete Asset List Apps Show App Create App Update App Video Object Photo Object Audio Object List Rooms Create Room Show Room Update Room Delete Room

Advanced microphone Configuration

You can configure your microphone by passing ina data attributes on your <microphone> tag. The id and app-id attributes are required.

Instance ID
Recording Name
Recording Description
Metadata
Sources
Preroll Count
Max Length
Min Length
Poll Server For Processed Event
#prompts
Default SMS Country
SMS Countries
Default SMS Message
Recording Stack
Permitted File Extensions
Existing UUID
Disable Audio Processing
Skip Preview
Audio Bit Rate

Instance ID

A unique identifier for this camera The default value is "myMic"

HTML

Vanilla JS

React JS

<microphone id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-id='myMic'></microphone>

CameraTag.init('targetDivID', 'microphone', {
  appUuid: '[YOUR_APP_UUID]',
  id: 'mymicrophone',
  id: ''
})

REACT

Recording Name

A human friendly name for the video to be recorded by this camera. This will be visible in your CameraTag admin and on YouTube (if you have YouTube export enabled)

HTML

Vanilla JS

React JS

<microphone id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-name='Billy Birthday Wish'></microphone>

CameraTag.init('targetDivID', 'microphone', {
  appUuid: '[YOUR_APP_UUID]',
  id: 'mymicrophone',
  name: 'Billy Birthday Wish'
})

REACT

Recording Description

A description for the video to be recorded by this camera. This will be visible in your CameraTag admin and on YouTube (if you have YouTube export enabled)

HTML

Vanilla JS

React JS

<microphone id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-description='Billy wishes grandma a very happy birthday during his soccer game.'></microphone>

CameraTag.init('targetDivID', 'microphone', {
  appUuid: '[YOUR_APP_UUID]',
  id: 'mymicrophone',
  description: 'Billy wishes grandma a very happy birthday during his soccer game.'
})

REACT

Metadata

A JSON string to be stored along with the video. This data will be made available in the server callback and the REST API. **Value must be validly formatted JSON (using double quotes) The default value is "{}"

HTML

Vanilla JS

React JS

<microphone id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-metadata='"{\"user_id\": 1234, \"user_name\": \"Jon Doe\"}"'></microphone>

CameraTag.init('targetDivID', 'microphone', {
  appUuid: '[YOUR_APP_UUID]',
  id: 'mymicrophone',
  metadata: "{\"user_id\": 1234, \"user_name\": \"Jon Doe\"}"
})

REACT

Sources

The default value is "record,upload,sms" Acceptable values are 'record', 'upload', 'sms'

HTML

Vanilla JS

React JS

<microphone id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-sources='record'></microphone>

CameraTag.init('targetDivID', 'microphone', {
  appUuid: '[YOUR_APP_UUID]',
  id: 'mymicrophone',
  sources: 'record'
})

REACT

Preroll Count

Number of seconds to count down before recording starts The default value is "5"

HTML

Vanilla JS

React JS

<microphone id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-preroll='5'></microphone>

CameraTag.init('targetDivID', 'microphone', {
  appUuid: '[YOUR_APP_UUID]',
  id: 'mymicrophone',
  preroll: '5'
})

REACT

Max Length

The max length (in seconds) of videos recorded (does not apply to uploads) The default value is "30"

HTML

Vanilla JS

React JS

<microphone id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-maxLength='30'></microphone>

CameraTag.init('targetDivID', 'microphone', {
  appUuid: '[YOUR_APP_UUID]',
  id: 'mymicrophone',
  maxLength: '30'
})

REACT

Min Length

The min length (in seconds) of videos recorded (does not apply to uploads) The default value is "3"

HTML

Vanilla JS

React JS

<microphone id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-minLength='3'></microphone>

CameraTag.init('targetDivID', 'microphone', {
  appUuid: '[YOUR_APP_UUID]',
  id: 'mymicrophone',
  minLength: '3'
})

REACT

Poll Server For Processed Event

Setting this legacyAttribute to false will instruct the camera not to poll our severs for the the 'processed' event. The default value is "true"

HTML

Vanilla JS

React JS

<microphone id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-pollForProcessed='true'></microphone>

CameraTag.init('targetDivID', 'microphone', {
  appUuid: '[YOUR_APP_UUID]',
  id: 'mymicrophone',
  pollForProcessed: true
})

REACT

HTML

Vanilla JS

React JS

<microphone id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-prompts='null'></microphone>

CameraTag.init('targetDivID', 'microphone', {
  appUuid: '[YOUR_APP_UUID]',
  id: 'mymicrophone',
  prompts: null
})

REACT

Default SMS Country

Sets the default country code listed in the SMS form (takes ISO 3166-1 alpha-2 codes) The default value is "us" Acceptable values are 'af', 'al', 'dz', 'as', 'ad', 'ao', 'ai', 'ag', 'ar', 'am', 'aw', 'au', 'at', 'az', 'bs', 'bh', 'bd', 'bb', 'by', 'be', 'bz', 'bj', 'bm', 'bt', 'bo', 'ba', 'bw', 'br', 'io', 'vg', 'bn', 'bg', 'bf', 'bi', 'kh', 'cm', 'ca', 'cv', 'bq', 'ky', 'cf', 'td', 'cl', 'cn', 'co', 'km', 'cd', 'cg', 'ck', 'cr', 'ci', 'hr', 'cu', 'cw', 'cy', 'cz', 'dk', 'dj', 'dm', 'do', 'ec', 'eg', 'sv', 'gq', 'er', 'ee', 'et', 'fk', 'fo', 'fj', 'fi', 'fr', 'gf', 'pf', 'ga', 'gm', 'ge', 'de', 'gh', 'gi', 'gr', 'gl', 'gd', 'gp', 'gu', 'gt', 'gn', 'gw', 'gy', 'ht', 'hn', 'hk', 'hu', 'is', 'in', 'id', 'ir', 'iq', 'ie', 'il', 'it', 'jm', 'jp', 'jo', 'kz', 'ke', 'ki', 'kw', 'kg', 'la', 'lv', 'lb', 'ls', 'lr', 'ly', 'li', 'lt', 'lu', 'mo', 'mk', 'mg', 'mw', 'my', 'mv', 'ml', 'mt', 'mh', 'mq', 'mr', 'mu', 'mx', 'fm', 'md', 'mc', 'mn', 'me', 'ms', 'ma', 'mz', 'mm', 'na', 'nr', 'np', 'nl', 'nc', 'nz', 'ni', 'ne', 'ng', 'nu', 'nf', 'kp', 'mp', 'no', 'om', 'pk', 'pw', 'ps', 'pa', 'pg', 'py', 'pe', 'ph', 'pl', 'pt', 'pr', 'qa', 're', 'ro', 'ru', 'rw', 'bl', 'sh', 'kn', 'lc', 'mf', 'pm', 'vc', 'ws', 'sm', 'st', 'sa', 'sn', 'rs', 'sc', 'sl', 'sg', 'sx', 'sk', 'si', 'sb', 'so', 'za', 'kr', 'ss', 'es', 'lk', 'sd', 'sr', 'sz', 'se', 'ch', 'sy', 'tw', 'tj', 'tz', 'th', 'tl', 'tg', 'tk', 'to', 'tt', 'tn', 'tr', 'tm', 'tc', 'tv', 'vi', 'ug', 'ua', 'ae', 'gb', 'us', 'uy', 'uz', 'vu', 'va', 've', 'vn', 'wf', 'ye', 'zm', 'zw'

HTML

Vanilla JS

React JS

<microphone id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-defaultSmsCountry='us'></microphone>

CameraTag.init('targetDivID', 'microphone', {
  appUuid: '[YOUR_APP_UUID]',
  id: 'mymicrophone',
  defaultSmsCountry: 'us'
})

REACT

SMS Countries

Which sms country codes should be abailable to the user The default value is "af,al,dz,as,ad,ao,ai,ag,ar,am,aw,au,at,az,bs,bh,bd,bb,by,be,bz,bj,bm,bt,bo,ba,bw,br,io,vg,bn,bg,bf,bi,kh,cm,ca,cv,bq,ky,cf,td,cl,cn,co,km,cd,cg,ck,cr,ci,hr,cu,cw,cy,cz,dk,dj,dm,do,ec,eg,sv,gq,er,ee,et,fk,fo,fj,fi,fr,gf,pf,ga,gm,ge,de,gh,gi,gr,gl,gd,gp,gu,gt,gn,gw,gy,ht,hn,hk,hu,is,in,id,ir,iq,ie,il,it,jm,jp,jo,kz,ke,ki,kw,kg,la,lv,lb,ls,lr,ly,li,lt,lu,mo,mk,mg,mw,my,mv,ml,mt,mh,mq,mr,mu,mx,fm,md,mc,mn,me,ms,ma,mz,mm,na,nr,np,nl,nc,nz,ni,ne,ng,nu,nf,kp,mp,no,om,pk,pw,ps,pa,pg,py,pe,ph,pl,pt,pr,qa,re,ro,ru,rw,bl,sh,kn,lc,mf,pm,vc,ws,sm,st,sa,sn,rs,sc,sl,sg,sx,sk,si,sb,so,za,kr,ss,es,lk,sd,sr,sz,se,ch,sy,tw,tj,tz,th,tl,tg,tk,to,tt,tn,tr,tm,tc,tv,vi,ug,ua,ae,gb,us,uy,uz,vu,va,ve,vn,wf,ye,zm,zw" Acceptable values are 'af', 'al', 'dz', 'as', 'ad', 'ao', 'ai', 'ag', 'ar', 'am', 'aw', 'au', 'at', 'az', 'bs', 'bh', 'bd', 'bb', 'by', 'be', 'bz', 'bj', 'bm', 'bt', 'bo', 'ba', 'bw', 'br', 'io', 'vg', 'bn', 'bg', 'bf', 'bi', 'kh', 'cm', 'ca', 'cv', 'bq', 'ky', 'cf', 'td', 'cl', 'cn', 'co', 'km', 'cd', 'cg', 'ck', 'cr', 'ci', 'hr', 'cu', 'cw', 'cy', 'cz', 'dk', 'dj', 'dm', 'do', 'ec', 'eg', 'sv', 'gq', 'er', 'ee', 'et', 'fk', 'fo', 'fj', 'fi', 'fr', 'gf', 'pf', 'ga', 'gm', 'ge', 'de', 'gh', 'gi', 'gr', 'gl', 'gd', 'gp', 'gu', 'gt', 'gn', 'gw', 'gy', 'ht', 'hn', 'hk', 'hu', 'is', 'in', 'id', 'ir', 'iq', 'ie', 'il', 'it', 'jm', 'jp', 'jo', 'kz', 'ke', 'ki', 'kw', 'kg', 'la', 'lv', 'lb', 'ls', 'lr', 'ly', 'li', 'lt', 'lu', 'mo', 'mk', 'mg', 'mw', 'my', 'mv', 'ml', 'mt', 'mh', 'mq', 'mr', 'mu', 'mx', 'fm', 'md', 'mc', 'mn', 'me', 'ms', 'ma', 'mz', 'mm', 'na', 'nr', 'np', 'nl', 'nc', 'nz', 'ni', 'ne', 'ng', 'nu', 'nf', 'kp', 'mp', 'no', 'om', 'pk', 'pw', 'ps', 'pa', 'pg', 'py', 'pe', 'ph', 'pl', 'pt', 'pr', 'qa', 're', 'ro', 'ru', 'rw', 'bl', 'sh', 'kn', 'lc', 'mf', 'pm', 'vc', 'ws', 'sm', 'st', 'sa', 'sn', 'rs', 'sc', 'sl', 'sg', 'sx', 'sk', 'si', 'sb', 'so', 'za', 'kr', 'ss', 'es', 'lk', 'sd', 'sr', 'sz', 'se', 'ch', 'sy', 'tw', 'tj', 'tz', 'th', 'tl', 'tg', 'tk', 'to', 'tt', 'tn', 'tr', 'tm', 'tc', 'tv', 'vi', 'ug', 'ua', 'ae', 'gb', 'us', 'uy', 'uz', 'vu', 'va', 've', 'vn', 'wf', 'ye', 'zm', 'zw'

HTML

Vanilla JS

React JS

<microphone id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-smsCountries='["us", "gb"]'></microphone>

CameraTag.init('targetDivID', 'microphone', {
  appUuid: '[YOUR_APP_UUID]',
  id: 'mymicrophone',
  smsCountries: '["us", "gb"]'
})

REACT

Default SMS Message

Change the default SMS message sent to users when using SMS mobile recording. You can use the <<url>> or <<uuid>> interpolation codes to have our server auomatically inject the current video's uuid and/or cameratag.com mobile recording page. The default value is "To record this video using your mobile phone please visit <<url>> in your mobile browser"

HTML

Vanilla JS

React JS

<microphone id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-defaultSmsMessage='To record this video using your mobile phone please visit <<url>> in your mobile browser'></microphone>

CameraTag.init('targetDivID', 'microphone', {
  appUuid: '[YOUR_APP_UUID]',
  id: 'mymicrophone',
  defaultSmsMessage: 'To record this video using your mobile phone please visit <<url>> in your mobile browser'
})

REACT

Recording Stack

Manually select the recording stack CameraTag will use (leave blank to have CameraTag auto-select based on client capabilities) The default value is "auto" Acceptable values are 'auto', 'webrtc', 'mediarecorder', 'mobile'

HTML

Vanilla JS

React JS

<microphone id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-defaultStack='mediarecorder'></microphone>

CameraTag.init('targetDivID', 'microphone', {
  appUuid: '[YOUR_APP_UUID]',
  id: 'mymicrophone',
  defaultStack: 'mediarecorder'
})

REACT

Permitted File Extensions

When uploading what file types should be allowed The default value is "mov,mp4,webm,flv,mv4,mov,avi,wmv,mpeg,mpg,m4v,wav,mp3,aif,aiff,aifc" Acceptable values are 'mov', 'mp4', 'webm', 'flv', 'mv4', 'mov', 'avi', 'wmv', 'mpeg', 'mpg', 'm4v', 'wav', 'mp3', 'aif', 'aiff', 'aifc'

HTML

Vanilla JS

React JS

<microphone id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-permittedExtensions='["mov", "mp4", "webm", "flv", "mv4", "mov", "avi", "wmv", "mpeg", "mpg", "m4v", "wav", "mp3", "aif", "aiff", "aifc"]'></microphone>

CameraTag.init('targetDivID', 'microphone', {
  appUuid: '[YOUR_APP_UUID]',
  id: 'mymicrophone',
  permittedExtensions: '["mov", "mp4", "webm", "flv", "mv4", "mov", "avi", "wmv", "mpeg", "mpg", "m4v", "wav", "mp3", "aif", "aiff", "aifc"]'
})

REACT

Existing UUID

If you would like to record with a UUID of your own derivation

HTML

Vanilla JS

React JS

<microphone id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-existingUuid='v-123-456-789'></microphone>

CameraTag.init('targetDivID', 'microphone', {
  appUuid: '[YOUR_APP_UUID]',
  id: 'mymicrophone',
  existingUuid: 'v-123-456-789'
})

REACT

Disable Audio Processing

Turn off advanced audio processing such as gain control and echo cancelation.

HTML

Vanilla JS

React JS

<microphone id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-disableAudioProcessing='true'></microphone>

CameraTag.init('targetDivID', 'microphone', {
  appUuid: '[YOUR_APP_UUID]',
  id: 'mymicrophone',
  disableAudioProcessing: true
})

REACT

Skip Preview

Skip the video review step and automatically publish after stopping

HTML

Vanilla JS

React JS

<microphone id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-skipPreview='true'></microphone>

CameraTag.init('targetDivID', 'microphone', {
  appUuid: '[YOUR_APP_UUID]',
  id: 'mymicrophone',
  skipPreview: true
})

REACT

Audio Bit Rate

The taregt bit rate for the audio stream (in bits per second) The default value is "128000"

HTML

Vanilla JS

React JS

<microphone id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-audioBitRate='128000'></microphone>

CameraTag.init('targetDivID', 'microphone', {
  appUuid: '[YOUR_APP_UUID]',
  id: 'mymicrophone',
  audioBitRate: '128000'
})

REACT