Package Exports

onezot-js-sdk
onezot-js-sdk/dist/index.js
onezot-js-sdk/dist/index.mjs

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (onezot-js-sdk) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

OneZot JS SDK

The OneZot JS SDK allows you to easily integrate real-time AI video avatars into your web applications. This SDK provides a simple interface to connect to OneZot's video avatar service.

Installation

npm install onezot-js-sdk
# or
yarn add onezot-js-sdk

Quick Start

import { OneZotSDK } from 'onezot-js-sdk';

// Initialize the SDK with your API key and avatar ID
const sdk = new OneZotSDK({
  apiKey: 'your-api-key-here', // Required: Your OneZot API key
  avatarId: 'your-avatar-id', // Required: Avatar ID to use
  onConnected: () => console.log('Connected to OneZot room'),
  onDisconnected: () => console.log('Disconnected from OneZot room'),
  onError: (error) => console.error('Error:', error)
});

// Get video and audio elements from your HTML
const videoElement = document.getElementById('video') as HTMLVideoElement;
const audioElement = document.getElementById('audio') as HTMLAudioElement;

// Connect to OneZot
try {
  const { onezotRoomName } = await sdk.connect(videoElement, audioElement);
  console.log('Connected to room:', onezotRoomName);
} catch (error) {
  console.error('Failed to connect:', error);
}

// Disconnect when done
await sdk.disconnect();

API Reference

OneZotSDK

Constructor

new OneZotSDK(options: OneZotSDKOptions)

Options

Parameter	Type	Required	Description
apiKey	string	Yes	Your OneZot API key
avatarId	string	Yes	ID of the avatar to use for video generation
onConnected	() => void	No	Callback when connected to the room
onDisconnected	() => void	No	Callback when disconnected from the room
onError	(error: Error) => void	No	Callback for error handling

Methods

connect

async connect(
  videoElement?: HTMLVideoElement,
  audioElement?: HTMLAudioElement
): Promise<{ onezotRoomName: string }>

Connects to a OneZot room and sets up video/audio streaming.

Parameters:

videoElement: Optional HTML video element to display the avatar
audioElement: Optional HTML audio element to play the avatar's audio

Returns:

onezotRoomName: The name of the room that was created

disconnect

async disconnect(): Promise<void>

Disconnects from the current OneZot room.

isConnectedToRoom

isConnectedToRoom(): boolean

Returns whether the SDK is currently connected to a room.

getAvatarId

getAvatarId(): string

Returns the avatar ID that was specified during initialization.

Example Usage

<!DOCTYPE html>
<html>
<head>
  <title>OneZot Demo</title>
</head>
<body>
  <video id="video" autoplay playsinline></video>
  <audio id="audio" autoplay></audio>

  <script type="module">
    import { OneZotSDK } from 'onezot-js-sdk';

    const sdk = new OneZotSDK({
      apiKey: 'your-api-key-here',
      avatarId: '27a57eb6-c517-4006-98f2-d9357b82ff87',
      onConnected: () => console.log('Connected!'),
      onDisconnected: () => console.log('Disconnected!'),
      onError: (error) => console.error('Error:', error)
    });

    const videoElement = document.getElementById('video');
    const audioElement = document.getElementById('audio');

    // Connect when a button is clicked
    document.getElementById('connect').addEventListener('click', async () => {
      try {
        const { onezotRoomName } = await sdk.connect(videoElement, audioElement);
        console.log('Connected to room:', onezotRoomName);
      } catch (error) {
        console.error('Failed to connect:', error);
      }
    });

    // Disconnect when another button is clicked
    document.getElementById('disconnect').addEventListener('click', async () => {
      await sdk.disconnect();
    });
  </script>

  <button id="connect">Connect</button>
  <button id="disconnect">Disconnect</button>
</body>
</html>

Available Avatars

The SDK requires a valid avatar ID to function. You can use any of the following stock avatars:

Avatar ID	Name	Ethnicity	Gender
27a57eb6-c517-4006-98f2-d9357b82ff87	Ching	Asian	Male
b523e8ef-b85b-4e77-9a61-9f8ffb687658	Sara	Caucasian	Female
347c0c95-ec73-467d-8a07-f73a084441a0	Jack	African	Male
6d47156b-0cff-4ec5-8628-a0fc9e1e2899	Amelia	Caucasian	Female
eaa7840e-c092-40df-844b-d5df5cef1123	Sam	Caucasian	Male
d1fbd6bc-d848-4e26-918e-4c05ae513190	Sandra	Caucasian	Female

Error Handling

The SDK provides error handling through the onError callback in the options. Common errors include:

Invalid API key
Invalid avatar ID
Network connectivity issues
Room connection failures
Media device access issues

Requirements

Modern browser with WebRTC support
Valid OneZot API key
Valid avatar ID
Internet connection

Browser Support

The SDK works in all modern browsers that support WebRTC, including:

Chrome
Firefox
Safari
Edge

License

MIT