persist_opaque
'persist_opaque' 指令用于决定在 API 调用期间是否维护不透明上下文。
Kaltura Media Framework Common NGINX Module
语法persist_opaque on | off;
默认值off
上下文
参数1
说明
'persist_opaque' 指令在 Kaltura Media Framework Common NGINX Module 中用于管理跨请求的不透明上下文的持久性。当该指令设为 '1' 时，允许 API 在后续交互中携带所需的特定上下文信息。在需要保持状态连续性的场景中，这一点非常重要，例如在直播会话期间，或当交互式媒体需求需要在多个请求间跟踪状态时。
该指令还接受一个参数以指定持久性行为。例如，若设为 '1'，不透明上下文将被保留并提供给处理后续请求的 API 方法。然而，如果将持久性功能关闭或设为 '0'，不透明上下文将不会被携带，这可能导致跨多次 API 调用的状态不一致问题。理解该指令如何与 API 请求生命周期交互，对于在 Kaltura 框架中工作的开发者来说至关重要，以在实时媒体应用中维持最佳功能和用户体验。
配置示例
location /api {
persist_opaque on;
proxy_pass http://backend_api;
}⚠
确保不透明的上下文不会变得过时；在跨 API 调用时小心管理状态。
⚠
使用 'persist_opaque off' 可能导致丢失重要的上下文信息，进而引发媒体处理错误。
⚠
检查与可能影响 API 中状态管理的其他模块或指令的兼容性。