# crypto_option_t结构体 参考 (/zh-CN/api-reference/rtsa/c/structcrypto-option-t)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
媒体流加密选项。
## 结构体成员变量说明 [#结构体成员变量说明]
### enable [#enable]
bool enable
是否开启媒体流加密:
- true: 开启加密。
- false: 关闭加密。
### key [#key]
char key[128+1]
媒体流加密密钥,字符串类型,长度至多为 128 字节。建议使用 32 字节的密钥。
:::info[注解]
如果未指定该参数或将该参数设置为 NULL,则无法启用媒体流加密,且 SDK 会返回错误码 -2。
:::
### mode [#mode]
[crypto_mode_e](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#a1e4f35ba0de825f5576535acfbaeb44e) mode
媒体流加密模式。详见 [crypto_mode_e](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#a1e4f35ba0de825f5576535acfbaeb44e)。建议使用 [AES_128_GCM2](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#a1e4f35ba0de825f5576535acfbaeb44ea23d6a46e00004410b9d00b41aba70e0d) 或 [AES_256_GCM2](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#a1e4f35ba0de825f5576535acfbaeb44ea13555f5e3977644e0fb20ee80e9b841a) 加密模式。这两种模式支持使用盐,安全性更高。
### salt [#salt]
uint8_t salt[32]
盐,长度为 32 字节。建议你在服务端使用 OpenSSL 生成盐。详见《媒体流加密》。
:::info[注解]
只有在 [AES_128_GCM2](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#a1e4f35ba0de825f5576535acfbaeb44ea23d6a46e00004410b9d00b41aba70e0d) 或 [AES_256_GCM2](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#a1e4f35ba0de825f5576535acfbaeb44ea13555f5e3977644e0fb20ee80e9b841a) 加密模式下,该参数才生效。此时,需确保填入该参数的值不全为 0。
:::
---
该结构体的文档由以下文件生成:
- agora_rtc_api.h