LogoLogo
ALO.ai
Developer Documentation
Developer Documentation
  • Developer Documentation
  • Developer Account
    • API Key
  • SDKs
    • Authentication
    • Chat
      • Configuration
      • Send Messages
        • Upload Files
      • Message History
      • Message Actions
      • Message Counts
      • Translation
      • Typing Indicators
      • API Reference
        • Event
        • Message
    • Presence
      • Configuration
      • Basic Usage
      • Methods
    • Audio
      • Prerequisites
      • Instantiating Audio Service
      • Connect to a Channel
      • Disconnecting Audio Service
      • Push To Talk (PTT)
      • Full Duplex
      • Mute and Unmute Audio
      • Input/Output Device Selection
        • Microphone Selection
        • Speaker Selection
      • Channel Participants
      • Text To Speech Audio (TTS)
      • Automatic Reconnects
      • Handling Events
      • Classes
        • AloAudio
        • AudioUser
        • AudioChannel
        • Participant
    • Video
      • Prerequisites
      • Instantiating Video Service
      • Connect to a Channel
      • Disconnecting Video Service
      • Input Device Selection
        • Microphone Selection
        • Camera Selection
      • Publishing Streams
      • Modifying Published Streams
      • Channel Participants
      • Rendering Streams
        • Local Stream
        • Remote Streams
      • Muting/Unmuting Remote Streams
      • Recording Video (coming soon)
      • Automatic Reconnects
      • Handling Events
      • Classes
        • AloVideo
        • Participant
        • VideoChannel
        • VideoUser
  • ALO APPS
    • Overview
    • Creating Apps
    • Webhooks
      • Verifying Requests from ALO
    • Custom Action Forms
    • Using the ALO Platform API
  • ALO Platform API
    • Overview
    • Authentication
    • API
      • Actions and Periods
      • Channels
      • Channel Messages
      • Channel Users
      • Direct Message Channels
      • Direct Message Channel Chat Messages
      • Direct Message Channel Users
      • Groups
      • Periods
      • Types
      • Users
      • Video Management System
  • Misc
    • Supported Language Codes
Powered by GitBook
LogoLogo

ALO.ai

  • ALO.ai

© Copyright 2025 ALO.ai, Inc. • All Rights Reserved

On this page
  • AloAudio Instantiation Properties
  • AloAudio Class
  • Connection Events
  • Sample Instantiation with Event Listeners:
  1. SDKs
  2. Audio

Instantiating Audio Service

PreviousPrerequisitesNextConnect to a Channel

Last updated 4 years ago

AloAudio Instantiation Properties

In order to instantiate the AloAudio object you are required to provide a number of properties. See .

AloAudio Class

Once you have defined the properties you instantiate as shown:

const aloAudio = new AloAudio(props);

Connection Events

Once instantiated, and , the user will be connected to the AloAudio Service. There are a number of event fire that are related to this connection:

Event

Description

onConnectionChange

As the connection to the Audio Service is established events showing the following statuses will be dispatched:

AloAudio.CONNECTION_STATUS_ACQUIRING_ACCESS, AloAudio.CONNECTION_STATUS_CONNECTING, AloAudio.CONNECTION_STATUS_CONNECTED, AloAudio.STATUS_NOT_CONNECTED, AloAudio.CONNECTION_STATUS_ERROR, AloAudio.CONNECTION_STATUS_CONNECTED, AloAudio.CONNECTION_STATUS_RECONNECT_PENDING.

onDisconnect

Once disconnected, either intentionally or due to an error, the onDisconnect event will be dispatched.

After you instantiate AloAudio you can add event listeners for the events mentioned above.

Sample Instantiation with Event Listeners:

function connectToAudio() {
    const user = new VideoUser (
      "12345",
      {        
        name: "James Jones",
        deviceId: "abcd-efsg-wqer-qewe"
      }
    );
    
    const props = {   
      userAuthToken: "token generated from Authentication Service",   
      ttsEnabled: true
    };
    aloAudio = new AloAudio(props);
    initializeEventListeners();
}

function initializeEventListeners() {
    aloAudio.events.addEventListener('onDisconnect', e => {
      console.log("onDisconnect:", e.detail);
    })

    aloAudio.events.addEventListener('onConnectionChange', action(e => {
      console.log("onConnectionChange:", e.detail);

      switch (e.detail.state) {
        case AloAudio.CONNECTION_STATUS_CONNECTED:
          console.log("Ālo audio connected");
          break;
        case AloAudio.CONNECTION_STATUS_DISCONNECTED:
          console.log("Ālo audio disconnected");
          break;
        case AloAudio.CONNECTION_STATUS_ERROR:
          console.log("Ālo audio connection error", e.detail);
          break;
        case AloAudio.CONNECTION_STATUS_CONNECTING:
          console.log("Ālo audio connecting");
          break;
        case AloAudio.CONNECTION_STATUS_RECONNECT_PENDING:
          console.log("Ālo audio reconnect pending.  Retrying in ", e.detail.pendingRestartSeconds);
          break;
      }

    }));
}

connected to a channel
Class Instantiation Properties