← 문서
기능 매트릭스
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 및 DELETE) 지원. 채널 객체에는 아직 오버라이드가 나열되지 않습니다. 자체 호스팅: 순서 변경 지원, 역할 오버라이드 지원(구성원 오버라이드 없음), 채널 객체에 나열됩니다 | |
| 채널별 권한 오버라이드 | 일부 지원 | 일부 지원 | 역할(그룹) 오버라이드만 있고 구성원 오버라이드는 없습니다. 쓰기(PUT, DELETE)는 클라우드와 자체 호스팅 모두에서 작동합니다. 읽기(채널 객체와 CHANNEL_UPDATE의 permission_overwrites)는 현재 자체 호스팅에서만 지원하며, 클라우드 채널 객체에는 이 필드가 없습니다. 자체 호스팅에서 allow는 그룹 자체에 허용된 범위를 넘어 권한을 주지 않습니다 | |
| 구성원 / 역할 / 차단 | 지원 | 지원 | 완전한 CRUD. communication_disabled_until(타임아웃)은 지원하지 않습니다 | |
| 웹훅(채널 & 앱) | 지원 | 지원 | 완전한 CRUD와 실행(임베드, 첨부, multipart). 자체 호스팅 서버에서는 레코드가 클라우드에 남고, 실행된 메시지는 자체 호스팅 채널에 기록됩니다 | |
| 앱 소유 이모지 | 포털 전용 | 포털 전용 | 개발자 포털에서 관리하며 봇 API의 GET은 동작합니다. 이모지를 참고하세요 | |
| 감사 로그 | 일부 지원 | 일부 지원 | 봇과 관련된 항목만. 채널별 오버라이드 이력은 색인하지 않습니다 | |
| 요청 제한 헤더 | 지원 | 지원 | 모든 응답에 X-RateLimit-*, 버킷 인식 | |
| 인터랙션 | 애플리케이션 명령어(슬래시, 사용자, 메시지) | 지원 | 지원 | 일괄 PUT과 개별 CRUD. 명령어는 두 종류의 서버 모두 클라우드에 등록되며, 자체 호스팅 서버에서의 호출은 클라우드를 거쳐 라우팅됩니다 |
| 버튼, 문자열 선택 메뉴, 모달(컴포넌트 v1) | 지원 | 지원 | 임시 응답도 지원합니다. 서버 채널에서만 동작하며 DM에서는 안 됩니다. 메시지 컴포넌트 참고 | |
| 사용자, 역할, 멘션 가능 대상, 채널 선택 메뉴 | 일부 지원 | 일부 지원 | 받아들여 저장하지만 클라이언트가 비활성 상태로 표시하므로 인터랙션이 발생하지 않습니다 | |
| 컴포넌트 v2 | 미지원 | 미지원 | 지원하지 않습니다. v2 레이아웃 컴포넌트는 표시되지 않습니다 | |
| HTTP 모드 인터랙션(아웃고잉 엔드포인트) | 일부 지원 | 일부 지원 | 설정된 interactions_endpoint_url로 Ed25519 서명과 함께 POST하며, 엔드포인트가 실패하면 게이트웨이로 대체됩니다. 연결된 게이트웨이 세션이 필요하고 응답 본문은 무시됩니다. 응답은 콜백 엔드포인트로 하세요. OAuth2 참고 | |
| 음성 | UDP 음성 게이트웨이 | 지원 | 지원 | 리전별. 음성 문서를 참고하세요 |
| AEAD AES-256-GCM | 지원 | 지원 | 권장 | |
| AEAD XChaCha20-Poly1305 | 지원 | 지원 | 대체 | |
| 봇에 의한 음성 상태 변경 | 지원 | 일부 지원 | 둘 다: 음소거 / 이동 / 연결 해제에는 PATCH .../voice-states/{user_id}를 사용합니다. 자체 호스팅은 deaf도 받아들이며 이동과 어떤 조합으로든 사용할 수 있습니다. 이동하면 이벤트가 한 개가 아니라 두 개 발생합니다 | |
| 기타 | 서버 이모지(읽기) | 지원 | 지원 | 목록과 조회. 생성/수정/삭제는 포털에서만 |
| 사운드보드(읽기) | 지원 | 지원 | 목록과 조회. 봇에 의한 재생은 지원하지 않습니다 | |
| 베니티 URL | 일부 지원 | 미지원 | 클라우드: 읽기와 수정(Gold 이상 서버). 자체 호스팅: PATCH는 501을 반환합니다 | |
| 스레드 / 포럼 게시물 | 일부 지원 | 일부 지원 | 포럼 게시물: 작성(POST /channels/{forum}/threads), 읽기, 답글을 지원합니다. 그 밖의 스레드 엔드포인트(보관, 스레드 구성원, 활성 스레드)는 지원하지 않습니다 | |
| 예약 이벤트 | 지원 | 일부 지원 | CRUD와 RSVP. GameVox 서버 이벤트에 매핑됩니다. GUILD_SCHEDULED_EVENT_* 게이트웨이 이벤트는 없습니다. 자체 호스팅: 반복 이벤트는 저장되지만 이후 회차는 생성되지 않습니다 | |
| 스테이지 채널, AutoMod | 미지원 | 미지원 | 인텐트는 받아들이지만 이벤트는 없습니다 | |
| Premium Apps / 엔타이틀먼트 | 미지원 | 미지원 | v1에는 수익화 계층이 없습니다 | |
| 포털 | 팀(여러 개발자의 공동 소유) | 지원 | Discord와 동등합니다. 팀을 참고해 주세요 | |
| 팀으로 앱 이전 | 지원 | 단방향(Discord와 같습니다) | ||
| 앱 테스터(비공개 앱 설치 허용 목록) | 지원 | 앱당 100명. 팀 → 테스터를 참고하세요 | ||
| OAuth2 설치 URL(사용자 + 서버 컨텍스트) | 지원 | 없음 / GameVox 제공 / 사용자 지정 URL. OAuth2를 참고해 주세요 | ||
| 클라이언트 시크릿 교체 | 지원 | bcrypt 해시. 생성과 교체 시 한 번만 표시됩니다 | ||
| 봇 디렉터리 등록 | 지원 | gamevox.com/bots에 운영진이 승인한 등록이 표시됩니다 | ||
범례
- 지원: Discord와 똑같이 동작하며 코드 변경이 필요 없습니다.
- 일부 지원: 와이어 수준에서는 호환되지만 일부 의미가 빠져 있습니다. 호출해도 안전하나 이벤트가 발생하지 않을 수 있습니다.
- 미지원: 와이어에서는 받아들이지만(4014는 나지 않습니다) 아무 일도 하지 않습니다. 없는 것으로 보고 설계하세요.