Frequently asked questions

Answers to the questions we hear most often about installing, authenticating, and running @bodytracker/sdk. Can't find what you're looking for? Search across every question below.

Installation

Frequently asked questions

Installation

Authentication

Permissions

Performance

Troubleshooting

Browser support

Frequently asked questions

Installation

Which package manager should I use?

Does this work with a CDN-only setup, no build step?

Do I need to install @bodytracker/react separately?

What's the minimum Node.js version for the build tooling?

Authentication

Where do I get an API key?

Can I use the SDK without a backend?

What's the difference between bt_live_ and bt_test_ keys?

Can one API key be used across multiple environments?

Permissions

Why does the browser ask for camera access?

What happens if the user denies camera permission?

Can I request permission before calling init()?

Can I switch cameras mid-session?

Performance

Does tracking impact page performance?

What does the smoothing config actually do?

How much bandwidth/CPU does this use?

Is there a recommended activityTypes list for lower overhead?

Troubleshooting

init() never resolves — what's wrong?

I'm not receiving movementChanged events

TypeScript can't find the module types

getStatus() returns 'error' — how do I debug it?

exportSession() rejects with a 'session not found' error

Browser support

Which browsers are supported?

Does this work on mobile Safari?

Is there a fallback for unsupported browsers?

Does the SDK work inside an iframe?