Голосовые подключения

1. основной Gateway wss://miscord.ru/gateway?v=1&encoding=json управляет состоянием;
2. Voice Gateway wss://miscord.ru/ws/voice-gateway?v=1 согласует UDP-медиасессию.

​

Требования

• приложение установлено с областями bot и applications.commands;
• роль бота имеет VIEW_CHANNEL и CONNECT;
• для отправки аудио требуется SPEAK, но бот без него может подключиться для прослушивания;
• включён intent GUILD_VOICE_STATES (1 << 7).

​

Запрос на подключение

{
  "op": 4,
  "d": {
    "guild_id": "SERVER_ID",
    "channel_id": "VOICE_CHANNEL_ID",
    "self_mute": false,
    "self_deaf": true
  }
}

{
  "op": 0,
  "t": "VOICE_SERVER_UPDATE",
  "d": {
    "token": "ONE_TIME_MEDIA_TICKET",
    "guild_id": "SERVER_ID",
    "endpoint": "miscord.ru/ws/voice-gateway?v=1"
  }
}

​

Voice Gateway handshake

1. Подключитесь к wss:// + endpoint и получите opcode 8 Hello.
2. Отправьте opcode 0 Identify.
3. Получите opcode 2 Ready с ssrc, ip, port и modes.
4. Выполните UDP discovery.
5. Отправьте opcode 1 Select Protocol с protocol: "udp".
6. Получите opcode 4 Session Description с 32-байтовым ключом.

{
  "op": 0,
  "d": {
    "server_id": "SERVER_ID",
    "user_id": "BOT_USER_ID",
    "session_id": "VOICE_SESSION_ID",
    "token": "ONE_TIME_MEDIA_TICKET",
    "max_dave_protocol_version": 0
  }
}

{
  "op": 1,
  "d": {
    "protocol": "udp",
    "data": {
      "address": "DISCOVERED_ADDRESS",
      "port": 50000,
      "mode": "aead_xchacha20_poly1305_rtpsize"
    }
  }
}

​

UDP discovery

• uint16be type = 1;
• uint16be length = 70;
• uint32be ssrc;
• 66 нулевых байт.

​

RTP и шифрование

• Opus: 48 кГц, stereo, 20 мс, 960 samples;
• RTP payload type: 120;
• SSRC берётся только из Ready и всегда является случайным uint32;
• обязательный режим: aead_xchacha20_poly1305_rtpsize;
• aead_aes256_gcm_rtpsize доступен, когда его поддерживает media-node;
• RTP header используется как AAD, шифруется только payload;
• к пакету добавляется четырёхбайтовый big-endian counter;
• сервер проверяет UDP tuple, SSRC и anti-replay окно.

​

Heartbeat и Resume