音视频移动开发【免费下载链接】react-native-videoA component for react-native项目地址https://gitcode.com/gh_mirrors/re/react-native-video点击查看免费下载本篇指南以 react-native-video 官方文档中的插件示例章节为核心面向希望为播放器注入自定义逻辑的开发者你将学会如何在 AndroidKotlin与 iOSSwift两端编写插件掌握生命周期钩子、源覆盖overrideSource与自定义 DRM 三大核心场景并理解插件注册表PluginsRegistry如何协调多个插件的执行顺序与失败处理。读完即可照抄模板落地自己的第一个插件。插件示例文档的背景插件系统的三大构件在进入示例之前先厘清示例所依托的运行时环境。react-native-video 的插件系统由三个构件组成见 插件总览构件作用PluginsRegistry单例负责插件注册、注销以及向所有插件分发事件通知、源处理、DRM 解析等ReactNativeVideoPluginSpec插件必须实现的接口/协议定义全部方法与属性契约ReactNativeVideoPlugin带默认实现的基类只需覆写关心的方法官方示例docs/docs/plugins/examples.md中的全部代码都建立在该基类之上Android 端基类位于 ReactNativeVideoPlugin.ktiOS 端基类位于 ReactNativeVideoPlugin.swift两者通过各自平台的 PluginsRegistry 完成统一注册与调度。示例文档的定位就是照此模板写插件的实操手册。基础插件模板一分钟搭起最小可用插件AndroidKotlin版本class MyPlugin : ReactNativeVideoPlugin(MyPlugin) { override fun onPlayerCreated(player: WeakReferenceNativeVideoPlayer) { Log.d(MyPlugin, Player created with uri ${player.get()?.source.uri}) } override fun onPlayerDestroyed(player: WeakReferenceNativeVideoPlayer) { Log.d(MyPlugin, Player destroyed) } override fun overrideSource(source: NativeVideoPlayerSource): NativeVideoPlayerSource { Log.d(MyPlugin, Overriding source with uri ${source.uri}) return source } } // Usage val plugin MyPlugin() // Automatically registered关键点逐条拆解构造参数即插件名基类ReactNativeVideoPlugin(override val name: String)会用RNV_Plugin_${name}自动生成唯一id见 ReactNativeVideoPlugin.kt。因此示例中ReactNativeVideoPlugin(MyPlugin)的插件 ID 为RNV_Plugin_MyPlugin。若注册同名插件注册表会覆盖旧实例Debug 下打印Replaced plugin ...详见 PluginsRegistry.kt。自动注册基类的init块在构造时调用PluginsRegistry.shared.register(this)所以示例末尾val plugin MyPlugin() // Automatically registered一句即完成注册无需额外代码。弱引用入参WeakReferenceNativeVideoPlayer防止插件长期持有播放器导致内存泄漏。读取时务必判空如player.get()?.source.uri。UnstableApi注解生命周期方法标注了 ExoPlayer 的UnstableApi覆写时需要同步标注基类已带注解可继承。iOSSwift版本class MyPlugin: ReactNativeVideoPlugin { init() { super.init(name: MyPlugin) } override func onPlayerCreated(player: WeakNativeVideoPlayer) { // Custom logic when player is created } override func onPlayerDestroyed(player: WeakNativeVideoPlayer) { // Custom cleanup when player is destroyed } override func overrideSource(source: NativeVideoPlayerSource) async - NativeVideoPlayerSource { // Modify source if needed return source } } // Usage let plugin MyPlugin() // Automatically registered关键点super.init(name:)完成注册与 ID 生成iOS 基类的public init(name: String)设置self.id RNV_Plugin_\(name)并调用PluginsRegistry.shared.register(plugin: self)见 ReactNativeVideoPlugin.swift因此 ID 规则与 Android 完全一致。iOS 的overrideSource是 async 方法源码契约func overrideSource(source:) async - NativeVideoPlayerSource内部可安全执行异步操作如网络请求鉴权头。iOS 独有的自动反注册基类没有显式deinit官方 interface 文档描述过deinit { PluginsRegistry.shared.unregister(plugin: self) }的写法因此在 iOS 上仍需自行管理反注册避免注册表残留强引用。跨平台行为差异速览维度AndroidiOS异步支持同步方法async/awaitsource 处理、DRM 获取插件 ID 生成RNV_Plugin_{name}RNV_Plugin_{name}自动注册构造时init 块构造时init自动反注册手动手动官方 interface 文档提到 deinit 写法示例文档未包含弱引用类型WeakReferenceTWeakT生命周期与源处理四个钩子 一个管线示例模板覆写了三个方法实际上ReactNativeVideoPluginSpec共定义7 个钩子详见 接口参考onPlayerCreated(player)播放器实例创建后触发。用途初始化播放器级资源、注册事件监听、下发播放器配置。onPlayerDestroyed(player)播放器销毁前触发。用途释放资源、移除监听、落盘状态或上报埋点。onVideoViewCreated(view)视频视图AndroidVideoView/ iOSVideoComponentView创建后触发。用途配置视图专属设置、挂 UI 事件、初始化覆盖层。onVideoViewDestroyed(view)视图销毁前触发。用途清理视图资源、移除 UI 事件、保存视图状态。overrideSource(source)播放前修改视频源。用途注入鉴权请求头、切换 CDN 地址、追加统计参数、转换源格式。getDRMManager(source)提供自定义 DRM 管理器。Android 专属三件套getMediaDataSourceFactory、getMediaSourceFactory、getMediaItemBuilder以及shouldDisableCache。源处理的执行顺序注册表在源进入播放管线前按注册顺序逐个调用overrideSource前一个插件的返回值作为后一个的输入见 PluginsRegistry.kt 与 PluginsRegistry.swiftinternal fun overrideSource(source: NativeVideoPlayerSource): NativeVideoPlayerSource { var overriddenSource source for (plugin in plugins.values) { overriddenSource plugin.overrideSource(overriddenSource) } return overriddenSource }internal func overrideSource(source: NativeVideoPlayerSource) async - NativeVideoPlayerSource { var overriddenSource source for plugin in plugins.values { overriddenSource await plugin.overrideSource(source: overriddenSource) } return overriddenSource }因此后注册的插件能覆盖前一个插件对源的修改——如果多个插件都想改源务必按基础处理在前、业务覆盖在后的顺序注册。DRM 插件自定义版权保护处理示例文档给出getDRMManager的标准实现当源声明了 DRM 保护且drmType custom时返回自定义管理器否则返回null让注册表继续询问下一个插件。class CustomDRMPlugin : ReactNativeVideoPlugin(CustomDRM) { override fun getDRMManager(source: NativeVideoPlayerSource): Any? { if (source.isDRMProtected() source.drmType custom) { return CustomDRMManager( licenseUrl source.drmLicenseUrl, certificateUrl source.drmCertificateUrl, keyId source.drmKeyId ) } return null } }class CustomDRMPlugin: ReactNativeVideoPlugin { init() { super.init(name: CustomDRM) } override func getDRMManager(source: NativeVideoPlayerSource) async - Any? { guard source.isDRMProtected() source.drmType custom else { return nil } return CustomDRMManager( licenseUrl: source.drmLicenseUrl, certificateUrl: source.drmCertificateUrl, keyId: source.drmKeyId ) } }底层解析逻辑谁在调用 getDRMManager注册表按注册顺序询问插件返回第一个非空管理器若所有插件都返回null则抛出LibraryError.DRMPluginNotFound见 PluginsRegistry.kt 与 PluginsRegistry.swiftinternal fun getDRMManager(source: NativeVideoPlayerSource): DRMManagerSpec { for (plugin in plugins.values) { val manager plugin.getDRMManager(source) if (manager ! null) return manager } throw LibraryError.DRMPluginNotFound }internal func getDrmManager(source: NativeVideoPlayerSource) throws - DRMManagerSpec? { for plugin in plugins.values { if let drmManager plugin.getDRMManager(source: source) { return drmManager } } throw LibraryError.DRMPluginNotFound.error() }注意示例中 Android 返回值写为Any?、iOS 写为Any?而实际接口契约是DRMManagerSpec?Android 见 ReactNativeVideoPlugin.kt、iOS 见 ReactNativeVideoPlugin.swift编写真实插件时应返回实现了DRMManagerSpec的对象。官方 DRM 插件的真实实现可对照的范例仓库内的 drm-plugin 包是上述模式的开箱即用参考实现。其 iOS 端 DRMPlugin.swift 直接覆写getDRMManager并处理了模拟器不支持 DRM 的分支class DRMPlugin: ReactNativeVideoPlugin { override func getDRMManager(source: any NativeVideoPlayerSource) - (any DRMManagerSpec)? { #if targetEnvironment(simulator) // DRM is not supported on the simulator. print([ReactNativeVideoDRM] DRM is not supported on the simulator. Returning nil.) return nil #else return DRMManager(source: source) #endif } }其对外 JS 入口 src/index.tsx 通过NitroModules.createHybridObjectPluginManagerSpec(PluginManager)暴露enable()/disable()/isEnabled说明官方 DRM 能力本身就是以插件形式挂载到播放器上的——这也是插件系统价值的最直接体现。重要警告DRM 插件当前的状态:::warning 官方文档明确标注React Native Video 目前尚未正式支持 DRM 插件。getDRMManager尚未完整实现调用将不会产生实际效果原文getDRMManageris not implemented yet and will have no effect。这意味着上文示例目前适合作为接口与模式的学习模板与接入预研落地生产前需关注库版本更新。仓库内已存在 drm-plugin 与 DRM 文档、v6 版 DRM 文档可据此追踪实现进度。 :::进阶Android 专属的 ExoPlayer 深度定制示例文档虽未展开但接口参考中 Android 插件还可覆写 4 个专属方法与overrideSource走同一套询问到第一个非空为止的调度逻辑见 PluginsRegistry.kt方法作用返回null时getMediaDataSourceFactory(source, dataSourceFactory)自定义数据源工厂缓存策略、网络优化、鉴权、采集使用默认工厂getMediaSourceFactory(source, mediaSourceFactory, dataSourceFactory)自定义媒体源工厂自定义格式支持、ExoPlayer 高级配置使用默认工厂getMediaItemBuilder(source, mediaItemBuilder)定制 MediaItem附加元数据、字幕、播放偏好、DRM 设置使用默认 buildershouldDisableCache(source)返回true禁用缓存直播流、DRM 内容、自定义缓存策略允许缓存iOS 侧没有这些钩子AVFoundation 可定制面有限属于 Android/ExoPlayer 生态的差异化能力。多个插件协同时的正确姿势注册顺序决定优先级源覆盖按注册顺序串联后注册覆盖先注册的修改DRM 管理器与工厂询问按注册顺序取第一个非空。未覆盖时返回null/ 原样返回getDRMManager、工厂方法返回null表示不处理overrideSource无改动时原样返回source。基类默认实现已如此Android 见 ReactNativeVideoPlugin.kt保证不覆写任何方法也不影响播放。妥善处理弱引用判空生命周期回调里拿到的 player/view 均为弱引用使用前判空避免空指针或 Swift 隐式解包崩溃。异步方法做好错误处理iOSoverrideSource、getDRMManager为 async内部应捕获并处理错误勿让异常穿透到播放管线。注意内存管理注册表对插件持有强引用插件对 player/view 只持有弱引用不再使用插件时执行PluginsRegistry.shared.unregister(plugin)防泄漏注册表文档 中对此有专门警示。记录有意义的日志Debug 构建下注册表本身会打印注册/替换/注销日志插件内适当打印业务日志可大幅降低排查成本。把插件接入你自己的工程若你在第三方库中使用插件需要在package.json将react-native-video声明为 dependency 或 peerDependency原生侧 iOS 在*.podspec声明s.dependency ReactNativeVideoAndroid 在build.gradle声明implementation project(:react-native-video)、implementation project(:react-native-nitro-modules)并引入androidx.media3依赖详见 第三方库接入指南。若你希望库方提供现成能力如广告、字幕样式、自定义 DRM 等可参考 Ask for Plugin 页面按流程提交需求。扩展阅读插件系统总览架构与核心概念插件注册表注册/注销、ID 生成、内部调度逻辑插件接口参考全部方法签名与参数说明DRM 文档DRM 功能现状与配置方式第三方库接入指南依赖声明与原生接入赞分享音视频移动开发【免费下载链接】react-native-videoA component for react-native项目地址https://gitcode.com/gh_mirrors/re/react-native-video点击查看免费下载相关推荐react-native-video 插件系统实战指南从 Analytics 集成到自定义 DRM 管理react native video 插件系统实战指南从 Analytics 集成到自定义 DRM 管理 导读 本指南基于 react native vid音视频移动开发react-native-video DRM 插件指南Widevine 与 FairPlay 集成实战react native video DRM 插件指南Widevine 与 FairPlay 集成实战 摘要 本文全面讲解 react native vid音视频移动开发React Native Video DRM 实战指南用 react-native-video/drm 集成 Widevine 与 FairPlayReact Native Video DRM 实战指南用 react native video/drm 集成 Widevine 与 FairPlay 本文讲音视频移动开发上一篇BentoPDF 的 PSD 转 PDF 完全指南浏览器内解析 Photoshop 文件、批量合并与隐私原理下一篇SKILL.md 触发机制完全指南name 与 description 如何决定 Claude 何时调用你的技能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
