react-native-video v6 DRM 集成指南：内置 `drm` prop 的完整配置与实战

音视频移动开发【免费下载链接】react-native-videoA component for react-native项目地址https://gitcode.com/gh_mirrors/re/react-native-video点击查看免费下载导读本文围绕 react-native-video v6 版本内置的drmprop 展开系统讲解在Video组件上完成 Widevine、FairPlay、PlayReady、ClearKey 等 DRM 方案配置的完整流程涵盖全部字段含义、License 获取、Cookie 传递与令牌过期处理等实战细节。读完本文你将能够在 Android / iOS 双端正确接入受版权保护的视频流并理解 v6 与 v7 在 DRM 架构上的本质差异。文章以仓库中的 v6 DRM 参考文档 为核心骨架并结合 v6 官方版本文档 与源码补充实现细节。v6 的 DRM 是内置能力无需额外安装包与 v7 不同在 react-native-videov6 中DRM 直接内建于核心库不需要安装任何额外的插件包。你只需要在Video组件上配置一个drm对象属性即可完成 DRM 播放的设置import Video, { DRMType } from react-native-video; Video source{{ uri: https://example.com/manifest.mpd }} drm{{ type: DRMType.WIDEVINE, // 使用枚举而不是字符串 licenseServer: https://license.example.com/wv, // 注意字段名是 licenseServer headers: { X-AxDRM-Message: token }, // iOS 和 Android 都会使用 }} /;几个关键点type必须使用从包中导出的DRMType枚举例如DRMType.WIDEVINE而不是手写字符串以便获得类型检查与自动补全v6 中字段名是licenseServerLicense 服务器地址这一点与 v7 的licenseUrl不同迁移时容易踩坑headers在 v6 中对iOS 与 Android 双端生效都作为 License 请求的自定义请求头使用。根据 v6 组件与属性参考在 v6 中drm等配置既可以直接作为Video的顶层 prop也推荐放在source内部即source.drm顶层 prop 仍然可用但被视为弃用写法。官方版本文档中明确指出配置 DRM 播放后该功能会在 Android 上禁用TextureView渲染表面会切回其他可用类型这是评估 DRM 方案时需要知道的渲染层行为。drm字段完整参考下表是 v6drm对象的全部字段来自 v6 DRM 参考文档 并补充了各字段的默认值与详细说明更权威的属性定义可查阅 v6 版本文档 drm.mdx字段类型平台说明typeDRMType枚举全部Android 支持WIDEVINE \| PLAYREADY \| CLEARKEYiOS 支持FAIRPLAY。默认undefinedlicenseServerstring全部授权受保护内容播放的 License 服务器 URL默认undefinedheadersobject全部License 请求的自定义请求头v6 中双端生效默认undefinedgetLicense(spc, contentId, licenseUrl, loadedLicenseUrl) base64iOS自定义 CKCContent Key Certificate获取函数按位置传参默认undefinedcertificateUrlstringiOSFairPlay 应用证书地址默认undefinedbase64CertificatebooleaniOS证书 URL 返回的数据是否为 Base64 格式默认falsecontentIdstringiOS覆盖内容 ID默认undefined未指定时取loadingRequest.request.URL.hostmultiDrmbooleanAndroid是否支持密钥轮换Key Rotation默认falselocalSourceEncryptionKeySchemestringiOS本地资源流加密密钥的 URL scheme默认undefined字段逐一详解type选择 DRM 体系type决定使用哪套 DRM 体系是驱动底层播放器初始化的关键字段AndroidDRMType.WIDEVINE最常用配合 DASH.mpd清单、DRMType.PLAYREADY、DRMType.CLEARKEYiOSDRMType.FAIRPLAY配合 HLS.m3u8清单。常见用法是结合Platform.OS为不同平台分别构造drm配置示例可参考仓库 example 应用的视频源工具。licenseServerLicense 服务器地址licenseServer是授权受保护内容播放的服务器 URL。在标准流程中播放器会向该地址发起 License 请求因此需要保证它与你的 DRM 服务商签发 token 的域名一致。示例drm: { type: DRMType.WIDEVINE, licenseServer: https://drm-widevine-licensing.axtest.net/AcquireLicense, headers: { X-AxDRM-Message: your-drm-header, }, }headersLicense 请求头双端生效v6 的headers会同时作用于 iOS 和 Android 的 License 请求最常见的用途是携带认证 token如 Axinom 的X-AxDRM-Message或会话 Cookie。它也是官方文档中向 License 服务器发送 Cookie的标准做法见下文实战场景。getLicenseiOS 自定义 License 获取当你不想或无法依赖licenseServer的标准流程时可以在 JavaScript 侧手动获取 License并把结果回传给原生模块完成 FairPlay 配置。函数签名为按位置传参的四个参数spcspcString用于 DRM 校验的 SPCServer Playback ContextcontentId来自 DRM 对象的 content ID或loadingRequest.request.url?.hostlicenseUrlDRM 对象中传入的licenseServer值loadedLicenseUrl从loadingRequest.request.URL.absoluteString取得、以skd://或clearkey://开头的 URL。你应当返回一个Base64 编码的 CKC 响应可以直接返回字符串也可以返回 Promise。官方文档给出的完整示例getLicense: (spcString, contentId, licenseUrl, loadedLicenseUrl) { const base64spc Base64.encode(spcString); const formData new FormData(); formData.append(spc, base64spc); return fetch(https://license.pallycon.com/ri/licenseManager.do, { method: POST, headers: { pallycon-customdata-v2: your-custom-header, Content-Type: application/x-www-form-urlencoded, }, body: formData, }) .then((response) response.text()) .then((response) response) .catch((error) console.error(Error, error)); };certificateUrl与base64CertificateFairPlay 应用证书FairPlay 需要一张应用证书App CertificatecertificateUrl用于获取合法 FairPlay 证书的 URLbase64Certificate布尔值声明证书 URL 返回的数据是否为 Base64 格式默认false即假设返回二进制。这两个字段均仅支持 iOS / visionOS。contentId内容 ID 覆盖用于显式指定流的内容 ID。如果省略系统会使用loadingRequest.request.URL.host即skd://请求 URL 的主机名作为内容 ID。在需要自定义内容标识与 License 服务端对齐时应显式设置。multiDrmAndroid 密钥轮换布尔值指示 DRM 系统是否支持密钥轮换Key Rotation。当内容在播放过程中更换加密密钥常见于长直播/长片源时设为true默认false。localSourceEncryptionKeyScheme本地资源密钥 scheme仅 iOS / visionOS用于设置本地资源已下载到本地的受保护媒体流加密密钥的 URL scheme例如localSourceEncryptionKeyScheme my-offline-key;实战场景一向 License 服务器发送 Cookie很多 License 服务器依靠会话 Cookie 做鉴权。在 v6 中直接通过headers传递即可无需额外的 Cookie 管理代码drm: { type: DRMType.WIDEVINE, licenseServer: https://drm-widevine-licensing.axtest.net/AcquireLicense, headers: { Cookie: PHPSESSIDyour-session-id; csrftokenmytoken; _gat1; foobar }, }实战场景二iOS FairPlay 自定义 License 获取当 License 服务端要求 JSON 格式的请求体而非标准表单提交时可完全在 JS 侧接管 CKC 的获取流程。完整示例来自 v6 官方文档drm: { type: DRMType.FAIRPLAY, getLicense: (spcString) { const base64spc Base64.encode(spcString); return fetch(YOUR_LICENSE_SERVER_URL, { method: POST, headers: { Content-Type: application/json, Accept: application/json, }, body: JSON.stringify({ getFairplayLicense: { foo: bar, spcMessage: base64spc, } }) }) .then(response response.json()) .then((response) { if (response?.getFairplayLicenseResponse?.ckcResponse) { return response.getFairplayLicenseResponse.ckcResponse; } throw new Error(No valid response); }) .catch((error) console.error(CKC error, error)); } }注意点getLicense只接收spcString时其余参数contentId、licenseUrl、loadedLicenseUrl仍可按签名顺序接收使用返回的是Base64 编码的 CKC可以是值或 Promise。实战场景三Token / License 过期处理DRM 的 License 与鉴权 token 都有有效期处理不当会出现播放到一半失败的线上事故。参考文档给出了明确的工程建议不要硬编码静态 token在getLicenseiOS中每次现场获取新鲜 tokenAndroid 侧则使用短时效的licenseServertoken或通过headers动态注入而非写死一个长期有效的值播放中途 token 过期通过ref.setSource(...)重新设置 source 触发重连或直接重挂载remountVideo组件该策略同时适用于 v6 与 v7属于通用 DRM 最佳实践。DRM 测试注意事项模拟器 vs 真机DRM 依赖设备级安全模块调试环境与生产环境行为差异很大务必了解以下限制iOS 模拟器没有 FairPlay 能力拿不到 DRM managerFairPlay 播放必须使用真机验证Android 模拟器一般可以处理 Widevine但如果出现异常行为请先在真机上复核再判断是否为业务代码问题因此DRM 的验收测试应以真机为准模拟器结果只作参考。v7 完全不同迁移要点速览参考文档强调v7 的 DRM 与 v6 完全不同v6 的drmprop 指南在 v7 中不适用。如果你在新项目上搭建 DRM应直接采用 v7 方案。v7 的差异可概括为包外置 配置上移v6drmpropv7source.drm内置在核心库独立的react-native-video/drm包启动时调用enable()licenseServerlicenseUrl字段更名multiDrmmultiSession字段更名type: DRMType.WIDEVINE枚举type: widevine字符串联合类型Android 常可省略headers双端生效iOS 用source.headersAndroid 用drm.licenseHeadersgetLicense(spc, contentId, licenseUrl, loadedLicenseUrl)位置传参getLicense({ contentId, licenseUrl, keyUrl, spc })对象传参base64Certificate、localSourceEncryptionKeyScheme已移除完整的逐项对照见 v7 DRM 参考 与 v6 → v7 迁移指南其中还包含字段重命名对照表licenseServer→licenseUrl、multiDrm→multiSession、枚举→字符串等。关联资源与深入阅读v6 DRM 参考文档本文的核心依据包含字段速查表与工程经验v6 官方版本文档 drm.mdx全部字段的权威定义、默认值与官方示例v6 props 完整文档drm与其他属性viewType、bufferConfig等的相互关系v6 组件与属性参考v6 整体心智模型与 props 总览v7 DRM 参考v7 插件化 DRM 的完整安装与配置流程v6 → v7 迁移指南含 DRM 字段重命名对照表仓库 example 应用可运行的真实集成示例含 DRM 相关源配置。如果你需要 DRM 内容的离线播放下载、存储、管理受保护与未受保护的流v6 官方文档建议评估 TheWidlarzGroup 的离线视频 SDK它额外处理了许多长期运营中才会遇到的边缘场景使用 v6 或 v7 均可接入。赞分享音视频移动开发【免费下载链接】react-native-videoA component for react-native项目地址https://gitcode.com/gh_mirrors/re/react-native-video点击查看免费下载相关推荐React Native Video DRM 实战指南用 react-native-video/drm 集成 Widevine 与 FairPlayReact Native Video DRM 实战指南用 react native video/drm 集成 Widevine 与 FairPlay 本文讲音视频移动开发react-native-video DRM 插件指南Widevine 与 FairPlay 集成实战react native video DRM 插件指南Widevine 与 FairPlay 集成实战 摘要 本文全面讲解 react native vid音视频移动开发react-native-video 从 v6 迁移到 v7Player 模型重写、逐项映射表与 DRM 改造实战指南react native video 从 v6 迁移到 v7Player 模型重写、逐项映射表与 DRM 改造实战指南 导读 react native vid音视频移动开发上一篇如何为OneNote打造专属语法高亮NoteHighlight2016插件开发实战指南下一篇使用 SQL Server R Services 与存储过程构建电信客户流失预测模型telco-customer-churn 示例全解析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考