LearnDash 视频 DRM：嵌入 Universal Player

开始之前#

先在 DRM-X 6.0 中发布加密视频并复制 Content ID，再创建具有 license-tokens:create 权限的服务器集成凭据。Site ID、Site Key 和 Access Key 保存在服务器配置中，浏览器只接收短期播放授权数据。

学习网站应使用 HTTPS。HTTP localhost 仅适合同一台电脑上的测试，HTTP 局域网地址不具备浏览器 DRM 所需的安全上下文。请使用受支持的浏览器和实际内容进行验证。

安装 LearnDash 集成#

使用你的授权安装包单独安装 LearnDash。从本指南下载 DRM-X WordPress 安装 ZIP，在 Plugins → Add Plugin → Upload Plugin 中上传。将现有 DRM-X 6.0 Universal Player 升级至 1.3.0-preview.5，同一网站只安装一份共享 WordPress 插件。

打开 Settings → DRM-X 6.0，保存服务器凭据，选择 LearnDash 或自动识别 LMS。默认保护策略应与加密输出包匹配。课时策略留空时，依次继承课程、网站和 DRM-X 环境策略。

在课时或主题中嵌入 Universal Player#

打开 LearnDash LMS → Courses，确认课时已加入课程目录，再以 WordPress 管理员身份打开 LearnDash LMS → Lessons 编辑课时。对于主题，请编辑主题本身，并保留其所属课时的关联。

在 Gutenberg 中添加 DRM-X Protected Video 区块，填写 Content ID、内容类型和保护策略。经典编辑器用户在正文下方的 DRM-X Protected Video 面板中填写这些值。在 Course and access rules 中选择 LearnDash。只有一个关联课程时可自动识别；共享课时需要明确选择应采用其权限规则的课程。

发布或更新课时。经典编辑器用户将播放器短代码复制到课时正文中；Gutenberg 用户也可以使用 Shortcode 区块。不要将短代码或加密播放清单填入 LearnDash 的 Video URL 字段。重新打开编辑器确认配置已保存，再以已报名学员身份打开原生课时页面。

报名、共享课时与学习进度#

课时页面和播放 REST 接口均检查当前 WordPress 用户、已保存的准确 Content ID 与内容类型，以及实际课程目录。选定课程和上级课时必须已发布；报名状态、有效期、前置课程、课程积分、课时及上级课时的分期开放时间、顺序学习限制均须允许访问。额外的会员限制仍然有效。

Universal Player 不会自动将 LearnDash 课时标记为完成，也不会驱动 LearnDash Video Progression。请使用正常的课时完成流程。除非已实现并测试完成状态对接，否则不要启用依赖 LearnDash 其他视频提供方的播放完成要求。

解决“Your account does not currently have access to this video”提示#

旧版 DRM-X 适配器错误地将 LearnDash 4.10.1 返回的课程标题当作课程 ID，并将 protected 课程模型方法当作公共 API 调用。1.3.0-preview.5 修复了这两处不兼容。请升级 DRM-X、清除页面缓存、重新保存课时映射，并确认关联课程名称。

若仍被拒绝，请检查学员的报名、有效期、前置课程、开放时间和会员要求。共享课时还需核对明确选择的课程。将受保护课时页面及 /wp-json/drmx/v1/playback-session 排除在共享缓存之外。排查付费课程时应保留 LMS 权限适配器。

已验证范围#

使用提供的 LearnDash 4.10.1 安装包，在隔离的 WordPress 7.1 中通过了 24 项原生检查。修复前已复现原始访问拒绝问题；修复后，登录学员的原生课时页面可以显示 Universal Player 并进入 Ready 状态。测试站没有 DRM-X 凭据，因此仍需用你的内容验证实际解密播放。其他 LearnDash 版本和付费扩展需要单独验收。