`\n\n```typescript\nawait presentation.end();\n```\n\n#### `presentation.getState()`\n\nGet the current presentation state.\n\n**Returns:** `PresentationState` - `'idle' | 'connecting' | 'connected' | 'disconnected'`\n\n```typescript\nconst state = presentation.getState();\nconsole.log(state); // 'connected'\n```\n\n#### `presentation.destroy()`\n\nDestroy the presentation instance and clean up all resources. Call this when removing the presentation from the page.\n\n**Returns:** `void`\n\n```typescript\npresentation.destroy();\n```\n\n#### `presentation.sessionId`\n\nRead-only property containing the unique session ID.\n\n```typescript\nconsole.log(presentation.sessionId); // 'session-abc123'\n```\n\n## Configuration Scenarios\n\n### Scenario 1: Basic Presentation (Minimal Config)\n\n```typescript\nconst presentation = createPresentation('container', {\n customerId: 'acme-corp',\n deckId: 'product-demo',\n supabaseUrl: 'https://your-project.supabase.co',\n supabaseKey: 'your-anon-key'\n});\n\nawait presentation.start();\n```\n\n### Scenario 2: With Manual Controls\n\n```typescript\nconst presentation = createPresentation('container', {\n customerId: 'acme-corp',\n deckId: 'product-demo',\n supabaseUrl: 'https://your-project.supabase.co',\n supabaseKey: 'your-anon-key',\n\n viewer: {\n showControls: true,\n controlsPosition: 'bottom'\n }\n});\n\nawait presentation.start();\n```\n\n### Scenario 3: With Lead Capture\n\n```typescript\nconst presentation = createPresentation('container', {\n customerId: 'acme-corp',\n deckId: 'product-demo',\n supabaseUrl: 'https://your-project.supabase.co',\n supabaseKey: 'your-anon-key',\n\n gating: {\n enabled: true,\n fields: ['name', 'email', 'company'],\n title: 'Get Access to Our Product Demo',\n description: 'Please provide your information to continue'\n }\n});\n\nawait presentation.start();\n```\n\n### Scenario 4: Full Configuration with Callbacks\n\n```typescript\nconst presentation = createPresentation('container', {\n customerId: 'acme-corp',\n deckId: 'product-demo',\n supabaseUrl: 'https://your-project.supabase.co',\n supabaseKey: 'your-anon-key',\n apiUrl: 'https://api.buzztrail.ai',\n\n viewer: {\n position: 'center',\n showControls: true,\n controlsPosition: 'bottom',\n aspectRatio: '16:9',\n showLoading: true,\n loadingMessage: 'Preparing your personalized demo...'\n },\n\n theme: 'auto',\n\n gating: {\n enabled: true,\n fields: ['name', 'email']\n },\n\n customerInfo: {\n name: 'Jane Smith',\n email: 'jane@example.com',\n company: 'Acme Inc'\n },\n\n debug: true,\n\n onStart: () => {\n console.log('Presentation started');\n // Track analytics, show UI elements, etc.\n },\n\n onEnd: () => {\n console.log('Presentation ended');\n // Hide UI elements, show follow-up actions, etc.\n },\n\n onError: (error) => {\n console.error('Presentation error:', error);\n // Show user-friendly error message\n },\n\n onStateChange: (state) => {\n console.log('State changed to:', state);\n // Update UI based on state\n if (state === 'connected') {\n // Show \"presentation is live\" indicator\n }\n }\n});\n\nawait presentation.start();\n```\n\n## Browser Support\n\n- Chrome/Edge: Latest 2 versions\n- Firefox: Latest 2 versions\n- Safari: Latest 2 versions\n- Mobile browsers: iOS Safari 14+, Chrome Android\n\n**Note**: Voice interaction requires browser support for WebRTC and getUserMedia API.\n\n## Troubleshooting\n\n### \"Domain not authorized\" Error\n\n**Solution**: Contact BuzzTrail support to authorize your domain. Domain authorization is managed by BuzzTrail admins for security purposes.\n\n### Camera/Microphone Not Working\n\n- **HTTPS Required**: Voice interaction only works on secure (HTTPS) websites\n- **Wix Users**: Use Custom Code (Settings → Advanced), NOT the Embed HTML element\n- **Browser Permissions**: Users must allow microphone access when prompted\n- **Check Container**: Ensure the container element exists before calling `createPresentation()`\n\n### Presentation Not Appearing\n\n- **Check Account**: Verify your BuzzTrail account is active\n- **Check Customer ID**: Ensure you're using the correct customer ID from your dashboard\n- **Check Deck ID**: Verify the deck ID exists and is published\n- **Check Supabase Credentials**: Ensure your Supabase URL and key are correct\n- **Check Container**: The HTML element with your container ID must exist on the page\n- **Check Console**: Open browser DevTools (F12) to see any error messages\n\n### Slides Not Advancing\n\n- **Voice Commands**: The AI voice agent controls slides based on conversation flow\n- **Manual Controls**: Enable manual controls with `viewer.showControls: true` if you want user control\n- **Database Connection**: Ensure Supabase credentials are correct - slides sync via database\n- **Network Issues**: Check browser console for network errors\n\n### Bot Spawn Failures\n\nIf you see \"Bot spawn failed\" errors:\n\n1. **Check API URL**: Verify `apiUrl` is correct (or omit to use default)\n2. **Check Session Creation**: Ensure the session was created successfully\n3. **Check Logs**: Enable `debug: true` to see detailed bot spawn logs\n4. **Retry**: Bot spawning includes automatic retry logic, wait a few seconds\n\n### Debugging Slide Control Issues\n\nEnable debug mode to see detailed logs:\n\n```typescript\nconst presentation = createPresentation('container', {\n customerId: 'acme-corp',\n deckId: 'product-demo',\n supabaseUrl: 'https://your-project.supabase.co',\n supabaseKey: 'your-anon-key',\n debug: true // Enable debug logging\n});\n```\n\nDebug logs will show:\n- Session creation\n- Bot spawn attempts\n- LiveKit room connection\n- Slide control commands\n- Error details with recovery strategies\n\n## Examples\n\n### Wix Example (Copy-Paste Ready)\n\n```html\n\n\n\n```\n\n### Generic HTML Example (Copy-Paste Ready)\n\n```html\n\n\n\n \n \n BuzzTrail Presentation Demo\n \n\n\n Product Demo Presentation
\n\n \n Initializing presentation...\n
\n\n \n\n \n \n\n \n\n\n```\n\n## Changelog\n\nSee [CHANGELOG.md](./CHANGELOG.md) for version history.\n\n## License\n\nProprietary - BuzzTrail AI\n\n---\n\n**Built with TypeScript** • **AI-Powered Presentations** • **Made for modern web platforms**\n","readmeFilename":"README.md"}