← 문서
기능 매트릭스
GameVox에서 Discord 봇 기능이 “동작하는가?”를 한눈에 보는 표입니다. 게이트웨이 URL을 바꾸기 전에 마이그레이션 범위를 가늠하는 데 사용하세요. 자체 호스팅 열은 고객이 자체 호스팅하는 GameVox 서버에 봇이 설치되었을 때 그 기능이 동작하는지를 나타냅니다. 전달 구조는 자체 호스팅 문서를 참고하세요.
| 영역 | 기능 | 클라우드 | 자체 호스팅 | 비고 |
|---|---|---|---|---|
| 게이트웨이 | JSON 인코딩 | 지원 | 지원 | 기본값이며 모든 라이브러리가 사용합니다 |
| zlib-stream 압축 | 지원 | 지원 | 주요 라이브러리가 모두 지원합니다 | |
| ETF 인코딩 | 미지원 | 미지원 | encoding=etf가 없으면 라이브러리가 JSON으로 되돌아갑니다 | |
| Zstandard 압축 | 미지원 | 미지원 | zlib-stream이 공통 대안입니다 | |
| Resume / op:6 | 지원 | 지원 | Resume 버퍼를 Redis에 복제하므로 api 태스크가 재시작돼도 op:6이 동작합니다 | |
| 샤딩 | 지원 | 지원 | 표준 (guild_id >> 22) % num_shards 해시 | |
| REST | 메시지 CRUD | 지원 | 지원 | 전송, 편집, 삭제, 일괄 삭제, 조회, 고정, 입력 표시, 반응 |
| 채널 CRUD | 지원 | 지원 | 클라우드: 권한 오버라이드와 순서 변경 포함. 자체 호스팅: 순서 변경은 지원하고, 채널별 오버라이드는 그룹을 사용합니다 | |
| 채널별 권한 오버라이드 | 지원 | 미지원 | 자체 호스팅은 그룹 단위 권한을 쓰므로 오버라이드 PUT은 501을 반환합니다 | |
| 구성원 / 역할 / 차단 | 지원 | 지원 | 완전한 CRUD. communication_disabled_until(타임아웃)은 지원하지 않습니다 | |
| 웹훅(채널 & 앱) | 지원 | 지원 | 완전한 CRUD와 실행(임베드, 첨부, multipart). 레코드는 클라우드에 남고, 실행 시 봇 전달 경로로 자체 호스팅 채널에 기록합니다 | |
| 앱 소유 이모지 | 포털만 | 포털만 | 개발자 포털에서 관리하며 봇 API의 GET은 동작합니다. 이모지를 참고하세요 | |
| 감사 로그 | 일부 지원 | 일부 지원 | 봇과 관련된 항목만. 채널별 오버라이드 이력은 색인하지 않습니다 | |
| 요청 제한 헤더 | 지원 | 지원 | 모든 응답에 X-RateLimit-*, 버킷 인식 | |
| 인터랙션 | 애플리케이션 명령어(슬래시, 사용자, 메시지) | 지원 | 미지원 | 클라우드: 일괄 PUT과 개별 CRUD. 자체 호스팅: 등록과 호출이 아직 라우팅되지 않습니다 |
| 컴포넌트 v1(버튼, 선택, 모달) | 지원 | 미지원 | GameVox 클라이언트에서 렌더링됩니다. 자체 호스팅에는 이벤트 브리지가 필요합니다 | |
| 컴포넌트 v2 | 미지원 | 미지원 | v1 이후로 계획되어 있습니다 | |
| HTTP 모드 인터랙션(외부 엔드포인트) | 지원 | 미지원 | 클라우드가 설정된 interactions_endpoint_url로 Ed25519 서명과 함께 전송하고, 엔드포인트가 죽으면 게이트웨이로 되돌아갑니다. 자체 호스팅에서의 호출은 아직 전달되지 않습니다 | |
| 음성 | UDP 음성 게이트웨이 | 지원 | 지원 | 리전별. 음성 문서를 참고하세요 |
| AEAD AES-256-GCM | 지원 | 지원 | 권장 | |
| AEAD XChaCha20-Poly1305 | 지원 | 지원 | 대체 | |
| 봇에 의한 음성 상태 변경 | 지원 | 일부 지원 | 둘 다: 음소거 / 이동 / 연결 해제에는 PATCH .../voice-states/{user_id}를 사용합니다. 자체 호스팅: deaf는 501(SFU에 해당 기능이 없음)이며, 이동은 이벤트를 하나가 아니라 둘 발생시킵니다 | |
| 기타 | 서버 이모지(읽기) | 지원 | 지원 | 목록과 조회. 생성/수정/삭제는 포털에서만 |
| 사운드보드(읽기) | 지원 | 지원 | 목록과 조회. 봇에 의한 재생은 지원하지 않습니다 | |
| 베니티 URL | 일부 지원 | 미지원 | 클라우드: 읽기와 수정(Gold 이상 서버). 자체 호스팅: PATCH는 501을 반환합니다 | |
| 스레드 / 포럼 게시물 | 자리표시 | 자리표시 | 포럼 채널은 있지만 스레드 CRUD는 빈 값이나 400을 반환합니다 | |
| 스테이지 채널, AutoMod, 예약 이벤트 | 미지원 | 미지원 | 인텐트는 받아들이지만 이벤트는 없습니다 | |
| Premium Apps / 엔타이틀먼트 | 미지원 | 미지원 | v1에는 수익화 계층이 없습니다 | |
| 포털 | 팀(여러 개발자의 소유) | 지원 | Discord와 동등합니다. 팀을 참고하세요 | |
| 팀으로 앱 이전 | 지원 | 단방향(Discord와 같습니다) | ||
| 앱 테스터(비공개 앱 설치 허용 목록) | 지원 | 앱당 100명. 팀 → 테스터를 참고하세요 | ||
| OAuth2 설치 URL(사용자 + 서버 컨텍스트) | 지원 | 없음 / GameVox 제공 / 사용자 지정 URL. OAuth2를 참고하세요 | ||
| 클라이언트 시크릿 교체 | 지원 | bcrypt 해시. 생성과 교체 시 한 번만 표시됩니다 | ||
| 봇 디렉터리 등록 | 지원 | gamevox.com/bots에 운영진이 승인한 등록이 표시됩니다 | ||
범례
- 지원: Discord와 똑같이 동작하며 코드 변경이 필요 없습니다.
- 일부 지원: 와이어는 호환되지만 일부 의미가 빠져 있습니다. 호출해도 안전하나 이벤트가 발생하지 않을 수 있습니다.
- 미지원: 와이어에서는 받아들이지만(4014은 나지 않습니다) 아무 일도 하지 않습니다. 없는 것으로 보고 설계하세요.