Портал разработчиков
Экспериментально Платформа для ботов и приложений активно развивается. Собственные серверы поддерживают ботов, слэш-команды и компоненты сообщений, с небольшими отличиями от облака. Посмотрите, что поддерживается.
← Документация

Матрица возможностей

Обзор в формате “а это работает?” по каждой функции ботов Discord в GameVox. Используйте его, чтобы оценить объём миграции, прежде чем менять URL шлюза. Столбец Собственный сервер показывает, работает ли функция, когда ваш бот установлен на собственном сервере GameVox клиента. Архитектура пересылки описана в документации по собственным серверам.

Область Функция Облако Собственный сервер Примечания
Шлюз Кодировка JSON Да Да По умолчанию; её используют все библиотеки
Сжатие zlib-stream Да Да Поддерживается всеми основными библиотеками
Кодировка ETF Нет Нет Библиотеки переключаются на JSON, если encoding=etf недоступен
Сжатие Zstandard Нет Нет zlib-stream является универсальной альтернативой
Возобновление / op:6 Да Да Буфер возобновления дублируется в Redis, поэтому op:6 переживает перезапуск задач api
Шардинг Да Да Стандартный хеш (guild_id >> 22) % num_shards
REST CRUD сообщений Да Да Отправка, изменение, удаление, массовое удаление, получение, закрепление, набор текста, реакции, файловые вложения, опросы
CRUD каналов Да Да Облако: изменение порядка и запись перезаписей для ролей (PUT и DELETE); объекты каналов пока не содержат перезаписей. Собственный сервер: изменение порядка есть, перезаписи для ролей есть (без перезаписей для участников), указаны в объектах каналов
Перезаписи прав для отдельных каналов Частично Частично Только перезаписи для ролей (групп), без перезаписей для участников. Запись (PUT, DELETE) работает в облаке и на собственном сервере. Чтение (permission_overwrites в объектах каналов и CHANNEL_UPDATE) пока есть только на собственном сервере; облачные объекты каналов не содержат этого поля. На собственном сервере разрешение никогда не даёт больше, чем разрешено самой группе
Участники / роли / баны Да Да Полный CRUD; communication_disabled_until (тайм-аут) не поддерживается
Вебхуки (канала и приложения) Да Да Полный CRUD + выполнение (эмбеды, вложения, multipart). На собственных серверах записи остаются в облачном хранилище, а сообщения, отправленные через вебхук, записываются в канал собственного сервера
Эмодзи приложения Только портал Только портал Управляются в портале разработчиков; GET в bot-API работает. См. Эмодзи
Журнал аудита Частично Частично Записи, важные для ботов; история перезаписей для отдельных каналов не индексируется
Заголовки рейт-лимитов Да Да X-RateLimit-* в каждом ответе, с учётом бакетов
Взаимодействия Команды приложения (слэш-команды, команды пользователя и сообщения) Да Да Массовый PUT + CRUD по отдельности. Команды регистрируются в облаке для обоих видов серверов; вызовы на собственных серверах маршрутизируются через облако
Кнопки, текстовые списки выбора, модальные окна (Компоненты v1) Да Да Эфемерные ответы тоже. Только в каналах сервера, не в ЛС. См. Компоненты сообщений
Списки выбора пользователей, ролей, упоминаемых объектов и каналов Частично Частично Принимаются и сохраняются; клиенты показывают их отключёнными, поэтому они никогда не вызывают взаимодействие
Компоненты v2 Нет Нет Не поддерживаются; компоненты разметки v2 не отображаются
Взаимодействия в режиме HTTP (исходящий эндпоинт) Частично Частично Отправляются POST-запросом на ваш interactions_endpoint_url с подписью Ed25519, с резервной доставкой через шлюз, если эндпоинт даёт сбой. Нужна подключённая сессия шлюза, а тело ответа игнорируется: отвечайте через эндпоинт обратного вызова. См. OAuth2
Голос Голосовой шлюз UDP Да Да По регионам. См. документацию по голосу
AEAD AES-256-GCM Да Да Предпочтительный
AEAD XChaCha20-Poly1305 Да Да Запасной
Изменение голосового состояния ботом Да Частично Везде: PATCH .../voice-states/{user_id} для отключения микрофона, перемещения и отключения от канала. Собственный сервер также принимает deaf, в любом сочетании с перемещением; перемещение даёт два события вместо одного
Прочее Эмодзи сервера (чтение) Да Да Список + получение; создание, изменение и удаление только через портал
Саундборд (чтение) Да Да Список + получение; воспроизведение ботом не поддерживается
Персональный URL (vanity) Частично Нет Облако: чтение + изменение (серверы Gold и выше). Собственный сервер: PATCH возвращает 501
Темы (threads) / публикации форумов Частично Частично Публикации форумов: можно создать публикацию (POST /channels/{forum}/threads), читать её и отвечать в ней. Остальные эндпоинты тем (архивирование, участники темы, активные темы) не поддерживаются
Запланированные события Да Частично CRUD и RSVP, сопоставляются с событиями сервера GameVox. Событий шлюза GUILD_SCHEDULED_EVENT_* нет. Собственный сервер: повторяющиеся события сохраняются, но последующие повторы не создаются
Stage-каналы, AutoMod Нет Нет Интенты принимаются, событий нет
Premium Apps / Entitlements Нет Нет В v1 нет слоя монетизации
Портал Команды (совместное владение) Да Как в Discord. См. Команды
Передача приложения команде Да Односторонняя (как в Discord)
Тестировщики (белый список установки закрытых приложений) Да 100 на приложение. См. Команды → Тестировщики
URL установки OAuth2 (контексты пользователя и сервера) Да Нет / от GameVox / собственный URL. См. OAuth2
Смена секрета клиента Да Хешируется bcrypt; показывается один раз при создании / смене
Публикация бота в каталоге Да Публикации с одобрением администратора на gamevox.com/bots

Обозначения

  • Да: работает как в Discord, без изменений кода.
  • Частично: совместимо по протоколу, но часть семантики отсутствует. Вызывать безопасно, но события могут не приходить.
  • Нет: принимается протоколом (не вызовет 4014), но ничего не делает. Исходите из того, что этого нет.

← Назад к документации