@performanc/voice

Performant Discord voice API client for ES6 Node.js

Features

Dependency-free
Lightweight
Stable

Dependencies

@performanc/pwsl

Installation

Release

$ npm install @performanc/voice

Development

$ npm install github:PerformanC/voice

Usage

import perfcVoice from '@performanc/voice'

...

const guildId = '123123123'
const userId = '123123123'

const connection =  perfcVoice.joinVoiceChannel({ guildId, userId, encryption: 'xsalsa20_poly1305_lite' })

client.ws.on('VOICE_STATE_UPDATE', (data) => {
  if (data.guild_id == guildId && data.member.user.id == userId) {
    connection.voiceStateUpdate({
      guild_id: guildId,
      user_id: userId,
      session_id: data.session_id
    })
  }
})

client.ws.on('VOICE_SERVER_UPDATE', (data) => {
  if (data.guild_id == guildId) {
    connection.voiceServerUpdate({
      token: buffer.token,
      endpoint: buffer.endpoint
    })

    stream.on('end', () => stream.emit('finishBuffering')) /* Allow it to end once it finds null */
    connection.connect(() => connection.play(stream))
  }
})

connection.on('stateChange', (_oldState, newState) => {
  if (newState.status == 'ready')
    console.log('Voice connection ready')
})

connection.on('playerStateChange', (_oldState, newState) => {
  if (newState.status === 'idle' && newState.reason === 'finished')
    console.log('End of audio')

  if (newState.status == 'playing' && newState.reason === 'requested')
    console.log('Playing audio')
})

Documentation

Hand-written documentation for all public methods, properties and functions can be found in the docs folder.

Troubleshoot

Audio not playing

@performanc/voice doesn't modify the audio stream in any way except for the encryption which is mandatory for Discord voice connections. If the audio is not playing, it is most likely an issue with the audio stream itself. Make sure the audio stream is valid and is not empty.

The audio stream must be a opus encoded audio stream, 48kHz, 2 channels, 20ms frame size. If the audio stream is not in this format, it must be converted to this format before being played.

Error: Session no longer valid

This error can occur even when the data is correct. This happens when Discord doesn't recognize that the last websocket session has been closed. This can be fixed by waiting for a few seconds before trying to connect again.

Support

Any question related to @performanc/voice or other PerformanC projects can be made in PerformanC's Discord server.

Contribution

It is mandatory to follow the PerformanC's contribution guidelines to contribute to @performanc/voice. Following its Security Policy, Code of Conduct and syntax standard.

Projects using @performanc/voice

NodeLink - LavaLink alternative written in Node.js.

License

@performanc/voice is licensed under BSD 2-Clause License. You can read more about it on Open Source Initiative.

This project is considered as: leading standard.

PerformanC / voice