@performanc/voice
v2.1.0
Published
Performant Discord voice API client for ES6 Node.js
Downloads
128
Readme
@performanc/voice
Performant Discord voice API client for ES6 Node.js
Features
- Dependency-free
- Lightweight
- Stable
Dependencies
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.