Advanced Camera Configuration
You can configure your camera by passing ina data attributes on your <camera> tag. The id and app-id attributes are required.CameraTag App UUID
Instance ID
Recording Name
Recording Description
Metadata
Sources
Default Mobile Camera
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
Flip Camera Preview
Screen Sharing
Disable Audio Processing
Skip Preview
Skip Hair Check
Video Bit Rate
Audio Bit Rate
CameraTag App UUID
The UUID for the CameraTag app that this camera should publish toHTML
Vanilla JS
React JS
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-appUuid=''></camera>
Instance ID
A unique identifier for this camera The default value is "myCamera"HTML
Vanilla JS
React JS
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-id='myCamera'></camera>
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
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-name='Billy Birthday Wish'></camera>
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
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-description='Billy wishes grandma a very happy birthday during his soccer game.'></camera>
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)HTML
Vanilla JS
React JS
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-metadata='"{\"user_id\": 1234, \"user_name\": \"Jon Doe\"}"'></camera>
Sources
What media sources are available to the user The default value is "record,upload,sms" Acceptable values are 'record', 'upload', 'sms'HTML
Vanilla JS
React JS
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-sources='["record","sms"]'></camera>
Default Mobile Camera
Which of the cameras on a mobile device should be used by default Acceptable values are '', 'environment', 'user'HTML
Vanilla JS
React JS
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-facingMode='environment'></camera>
Preroll Count
Number of seconds to count down before recording starts The default value is "3"HTML
Vanilla JS
React JS
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-preroll='5'></camera>
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
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-maxLength='30'></camera>
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
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-minLength='3'></camera>
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
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-pollForProcessed='true'></camera>
Prompts
Prompts are text prompts that display to the user as they are recording. Each prompt can have a max and min response time.HTML
Vanilla JS
React JS
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-prompts='[{"text":"What is your name","minLength":5,"maxLength":20}]'></camera>
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
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-defaultSmsCountry='us'></camera>
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
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-smsCountries='["us","gb"]'></camera>
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
<camera 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'></camera>
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
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-defaultStack='mediarecorder'></camera>
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
<camera 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"]'></camera>
Flip Camera Preview
Flpe the recording preview horziontally to it's easier for the user to orient themsleves The default value is "true"HTML
Vanilla JS
React JS
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-flipRecordPreview='true'></camera>
Disable Audio Processing
Turn off advanced audio processing such as gain control and echo cancelation.HTML
Vanilla JS
React JS
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-disableAudioProcessing='true'></camera>
Skip Preview
Skip the video review step and automatically publish after stoppingHTML
Vanilla JS
React JS
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-skipPreview='true'></camera>
Skip Hair Check
Skip the haircheck screen and record immediatelyHTML
Vanilla JS
React JS
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-skipHairCheck='true'></camera>
Video Bit Rate
The target bit rate for the video stream (in bits per second) The default value is "1200000"HTML
Vanilla JS
React JS
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-videoBitRate='1200000'></camera>
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
<camera id='MyRecorder1' data-app-id='[YOUR_APP_UUID]' data-audioBitRate='128000'></camera>