菜单
Work with DiscordPHP's voice subsystem — voice gateway protocol opcodes, encryption (VoiceGroupCrypto), voice packets, audio streaming, and Discord.php voice integration. Use when touching Voice/*, joinVoiceChannel, or voice encryption/packet logic.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | voice-subsystem-keeper |
| description | Work with DiscordPHP's voice subsystem — voice gateway protocol opcodes, encryption (VoiceGroupCrypto), voice packets, audio streaming, and Discord.php voice integration. Use when touching Voice/*, joinVoiceChannel, or voice encryption/packet logic. |
Use this skill when work touches src/Discord/Voice/*, Discord::joinVoiceChannel(), voice event handlers in Discord.php, or anything involving audio encryption and packets.
Voice support is split across three locations. Understand the boundary before touching any of them:
| Location | What lives here |
|---|---|
src/Discord/Voice/* | Internal protocol types: opcodes (Hello, Ready, Speaking), session description, voice packets, encryption classes and traits. These are pure data/crypto — no audio I/O. |
src/Discord/Discord.php | Runtime integration: joinVoiceChannel(), voice state update handlers, voice server update handlers. This is where the external voice client is wired to gateway events. |
discord-php-helpers/voice (external package) | Manager and VoiceClient: actual audio I/O, Opus encoding, UDP transport, stream management. DiscordPHP delegates audio work here. |
Rule: do not blur these boundaries. Protocol types belong in Voice/*, audio I/O belongs in the external package, and wiring belongs in Discord.php.
src/Discord/Voice/VoiceGroupCrypto.php — encryption/decryption base classsrc/Discord/Voice/VoiceGroupCryptoTrait.php — mixin providing group-based AEAD cryptosrc/Discord/Voice/VoiceGroupCryptoInterface.php — contractsrc/Discord/Voice/VoicePacket.php — encrypted RTP packet encapsulationsrc/Discord/Voice/SessionDescription.php — session key and mode negotiationsrc/Discord/Voice/Speaking.php, src/Discord/Voice/Hello.php, src/Discord/Voice/Ready.php, src/Discord/Voice/Resumed.php — voice gateway opcodessrc/Discord/Voice/Platform.php, src/Discord/Voice/Region.php — enum helperssrc/Discord/Discord.php — search for joinVoiceChannel, VOICE_STATE_UPDATE, VOICE_SERVER_UPDATEsrc/Discord/Helpers/Buffer.php — writable stream for audio buffering (extends EventEmitter)Discord voice uses a separate WebSocket gateway from the main gateway. The handshake sequence is:
Hello — server sends heartbeat intervalIdentify — client sends token + sessionReady — server sends UDP endpoint + SSRCSelect Protocol — client sends chosen encryption modeSession Description — server sends secret keySpeaking — sent before/after transmitting audioThe classes in src/Discord/Voice/ model these protocol steps as typed value objects.
VoiceGroupCrypto provides AEAD encryption for RTP packets. It depends on libsodium (ext-sodium). The trait VoiceGroupCryptoTrait provides the implementation; concrete classes select the cipher mode (e.g., aead_xchacha20poly1305_ietf).
LibSodiumNotFoundException is thrown at runtime if the extension is absent — do not suppress itSessionDescriptionVoicePacket encapsulates an encrypted RTP packet:
discord-php-helpers/voice owns all audio work:
Do not replicate any of this in src/Discord/Voice/. If you need to add audio capability, contribute to the external package or wrap it.
OldVoiceClient.php, OldBuffer.php, OldOggStream.php, OldOggPage.php, OldOpusHead.php, OldOpusTags.php, OldReceiveStream.php are legacy implementations. They are preserved for compatibility only.
Do not extend, copy patterns from, or add new features to any Old* class. Fix bugs in them only when the fix is isolated and does not require architectural change.
When touching voice code, also inspect:
| Touching | Also inspect |
|---|---|
VoiceGroupCrypto or crypto mode | SessionDescription, VoicePacket, VoiceGroupCryptoInterface, LibSodiumNotFoundException |
Speaking or voice gateway opcode | Hello, Ready, Resumed, SessionDescription — full handshake chain |
Discord.php voice handlers | Voice gateway opcodes, Buffer, external voice package Manager |
Buffer.php | Multipart.php (similar streaming pattern), external voice package stream classes |
| Any new voice encryption mode | VoiceGroupCryptoInterface, crypto trait, SessionDescription mode list |
SessionDescription.VoiceGroupCryptoTrait or extending VoiceGroupCrypto.VoiceGroupCryptoInterface if the contract changes.LibSodiumNotFoundException if missing.src/Discord/Voice/ mirroring the Discord voice gateway docs.Discord.php (find the voice WebSocket message handler).src/Discord/Voice/ — that belongs in the external voice packageOld* class for new featuresSessionDescriptionLibSodiumNotFoundException silently instead of surfacing it to the callersrc/Discord/Voice/VoiceGroupCrypto.php — encryption basesrc/Discord/Voice/VoicePacket.php — RTP packet wrappersrc/Discord/Voice/SessionDescription.php — session key/modesrc/Discord/Voice/Speaking.php — voice speaking opcodesrc/Discord/Helpers/Buffer.php — writable stream helpersrc/Discord/Exceptions/LibSodiumNotFoundException.php — crypto dependency guardsrc/Discord/Exceptions/OpusNotFoundException.php — codec dependency guardsrc/Discord/Exceptions/FFmpegNotFoundException.php — audio tool dependency guardMaintain test and documentation alignment — PHPUnit tests, async testing patterns, PHPDoc contracts, guide pages, and documentation workflow. Use when adding tests, updating docs, or changing public behavior.
Maintain Builder classes — outbound payload construction, validation, serialization, component handling, and fromPart symmetry. Use when changing Builders or outbound Discord API payloads.
Maintain gateway event handlers — payload hydration, cache mutation, event return shapes, and handler registration. Use when touching WebSockets/Events, Handlers.php, or Event.php.
Work with DiscordPHP's infrastructure utilities — CacheWrapper, CacheConfig, BigInt, Multipart, Endpoint::bind URL templates, Collection base class, and domain Exceptions. Use when changing cache behavior, REST endpoint routing, file uploads, big-integer ID math, or adding/modifying exceptions.
Maintain interaction flow — Interaction typing, resolved data caching, command routing, autocomplete, modal responses, and interaction builders. Use when touching Interactions or slash command handling.
Maintain the optional prefix-command layer — DiscordCommandClient, Command class, parsing, aliases, cooldowns, and help system. Use when touching message-based command handling.