1. 为什么Unity里播放加密视频是个头疼事我猜很多做游戏或者应用开发的朋友都遇到过这个需求想在Unity里播放视频但又不想让别人轻易把视频文件拷走。比如你做了个付费课程App里面的教学视频都是精心制作的或者你开发了一款剧情向游戏过场动画是核心资产。直接扔个MP4文件进去稍微懂点技术的人分分钟就能从安装包里把它扒出来这肯定不行。最开始我也试过Unity自带的VideoPlayer组件这东西播个普通视频还行但一说到加密它就完全没辙了。官方没提供任何接口让你在播放前对视频流做解密处理。我也走过不少弯路比如把视频文件打包成AssetBundle然后在AB包文件里塞点“垃圾数据”干扰一下播放前再把这些干扰字节去掉。这个方法听起来好像能防一下但实际用起来问题一大堆。最要命的是你得把整个加密视频文件全部下载完、解密完才能开始播放。一个几百兆的视频用户得干等半天体验极差。而且视频一多、一大在内存小的设备上比如一些老款手机很容易直接崩溃根本扛不住。还有个更“原始”的办法把加密视频当成二进制数据存起来播放的时候在本地临时目录还原成一个正常的视频文件播完再删掉。这个方法听起来挺巧妙但实际上更不安全。临时文件在播放期间是完整存在的只要用户手速够快或者用一些文件监控工具很容易就能把这个临时文件截获。而且每次播放都要经历一次“解密-写入文件”的过程等待时间一点没少还增加了被破解的风险。所以折腾了一圈我发现想兼顾安全和体验尤其是流式播放也就是边下边播靠Unity原生组件或者自己写底层解密播放器门槛实在太高了。这时候专业的第三方插件就成了最优解。我最后选的是AVPro Video这插件在Unity圈子里名气很大功能也确实强悍。它原生支持HLS (HTTP Live Streaming)协议而HLS协议本身就有一套成熟的加密方案AES-128加密。这意味着我们可以用标准化的工具来制作加密视频然后直接在AVPro Video里播放插件内部会帮我们处理好解密和流式加载的所有脏活累活。这简直就是为我们这种需要内容保护又追求流畅播放的场景量身定做的方案。2. 动手之前搞懂HLS加密是怎么回事在撸起袖子敲代码之前咱们得先花几分钟把HLS加密的基本原理搞明白这样后面每一步操作你都知道是在干嘛出了问题也知道往哪儿找原因。放心我用最“人话”的方式给你讲清楚。你可以把HLS加密想象成以前租录像带看电影。制片方我们把一部完整的电影原始MP4视频切成很多个小片段比如每6秒一个.ts文件就像把一部电影录到好几盘录像带上。同时我们会制作一个目录清单.m3u8文件这个清单上写着“第一盘带子在哪儿第二盘在哪儿…”。关键来了为了防止别人偷看我们在把电影录到录像带之前用一个密码箱AES-128加密算法把每一盘录像带都锁了起来。这个密码箱的钥匙一个16字节的密钥就是enc.key文件只有我们和合法的播放器比如AVPro Video才有。那个目录清单.m3u8文件里除了记录每盘带子的位置还会额外写上一行说明“播放这些带子需要钥匙钥匙的存放地址是XXX比如http://yourserver.com/enc.key”。当播放器比如用户的手机App拿到这个目录清单.m3u8后它会先按照指示去指定的地址可能是你的服务器请求拿钥匙enc.key。拿到钥匙后它再一边下载那些被锁住的录像带片段.ts文件一边用钥匙开锁解密然后立刻播放。播完一盘一个片段就接着下载、解密、播放下一盘。这就是“流式播放”的精髓不用等整个电影下载完可以立即开始看而且后续内容在后台默默加载。这里还有个小细节叫IV初始化向量。你可以把它理解成给密码箱加了个“动态密码”。如果只用同一把钥匙密钥锁所有箱子理论上存在被破解模式的风险。IV就是一个每次加密时都不同的随机数它和密钥一起确保即使视频内容相同加密后的结果也不同安全性大大提升。在HLS里IV可以写在那个目录清单.m3u8里告诉播放器。所以我们整个工作流就清晰了准备钥匙生成一个16字节的密钥enc.key和一个可选的IV。制作带密码箱的录像带用FFmpeg这个强大的工具把原始MP4视频切成小片段并用我们准备好的钥匙和IV对每一个片段进行AES-128加密最终生成一堆.ts文件和一个.m3u8清单文件。部署把加密后的.ts文件、.m3u8清单文件放到服务器或CDN上。钥匙enc.key也需要放在一个安全的、播放器能访问到的地址比如你的后端接口。在Unity中播放在AVPro Video插件里告诉它.m3u8文件的地址以及如何获取钥匙直接提供钥匙内容或者提供一个动态获取钥匙的URL。3. 第一步准备你的“钥匙”——生成HLS加密密钥好了理论过关咱们开始实战。第一步就是制作开锁的“钥匙”也就是HLS加密所需的密钥和IV。手动去算这些16进制的字节太麻烦了而且容易出错。我习惯在Unity编辑器里写一个小工具点几下按钮就全部搞定安全又方便。下面这个编辑器窗口脚本你可以直接创建一个C#脚本比如叫HLSKeyGeneratorWindow.cs放在Editor文件夹下。它提供了两个核心功能生成密钥文件以及把密钥转换成方便网络传输的Base64字符串。using UnityEditor; using UnityEngine; using System.IO; using System.Security.Cryptography; using System.Text; public class HLSKeyGeneratorWindow : EditorWindow { private static string HLSFolderPath Application.streamingAssetsPath /HLS; [MenuItem(Tools/HLS/生成加密密钥)] public static void GenerateHLSKeys() { // 确保HLS目录存在 if (!Directory.Exists(HLSFolderPath)) { Directory.CreateDirectory(HLSFolderPath); } // 1. 生成16字节的AES-128密钥并保存为 enc.key 文件 string keyFilePath HLSFolderPath /enc.key; byte[] keyBytes GenerateRandomBytes(16); // AES-128需要16字节 File.WriteAllBytes(keyFilePath, keyBytes); Debug.Log($密钥已生成并保存至: {keyFilePath}); // 2. 生成16字节的IV初始化向量 byte[] ivBytes GenerateRandomBytes(16); string ivHexString ByteArrayToHexString(ivBytes).ToLower(); // 转换成小写十六进制字符串 Debug.Log($生成的IV十六进制: {ivHexString}); // 3. 生成 key_info.txt 文件这是FFmpeg加密时需要用的配置文件 string keyInfoFilePath HLSFolderPath /key_info.txt; // 第一行密钥URI播放器会根据这个地址去获取密钥。我们先写个本地路径示例。 string keyUriForPlayer enc.key; // 第二行密钥在本地文件系统的绝对路径供FFmpeg读取。 string keyUriForFFmpeg keyFilePath; StringBuilder sb new StringBuilder(); sb.AppendLine(keyUriForPlayer); sb.AppendLine(keyUriForFFmpeg); sb.AppendLine(ivHexString); // 第三行IV可选但推荐加上 File.WriteAllText(keyInfoFilePath, sb.ToString()); Debug.Log($key_info.txt 已生成至: {keyInfoFilePath}); Debug.Log($内容预览:\n{sb.ToString()}); AssetDatabase.Refresh(); // 刷新Unity资源数据库让生成的文件在Project窗口显示出来 EditorUtility.DisplayDialog(成功, HLS加密密钥及配置文件已生成完毕\n请查看StreamingAssets/HLS/目录。, 确定); } [MenuItem(Tools/HLS/获取密钥Base64字符串)] public static void GetKeyBase64() { string keyFilePath HLSFolderPath /enc.key; if (!File.Exists(keyFilePath)) { EditorUtility.DisplayDialog(错误, 未找到密钥文件请先执行“生成加密密钥”。, 确定); return; } byte[] keyBytes File.ReadAllBytes(keyFilePath); string base64Key System.Convert.ToBase64String(keyBytes); // 将Base64字符串复制到系统剪贴板方便粘贴到后端或配置中 GUIUtility.systemCopyBuffer base64Key; Debug.Log($密钥Base64字符串已复制到剪贴板: {base64Key}); EditorUtility.DisplayDialog(成功, $密钥Base64字符串已复制到剪贴板。\n{base64Key}, 确定); } // 生成指定长度的随机字节数组 private static byte[] GenerateRandomBytes(int length) { byte[] randomBytes new byte[length]; using (RNGCryptoServiceProvider rng new RNGCryptoServiceProvider()) { rng.GetBytes(randomBytes); } return randomBytes; } // 将字节数组转换为十六进制字符串 private static string ByteArrayToHexString(byte[] bytes) { return BitConverter.ToString(bytes).Replace(-, ); } }如何使用这个工具在Unity编辑器的顶部菜单栏点击Tools - HLS - 生成加密密钥。脚本会自动在Assets/StreamingAssets/HLS/目录下生成三个文件enc.key 二进制密钥文件这是核心机密。key_info.txt FFmpeg工具的配置文件里面包含了密钥路径和IV信息。注意output.m3u8和.ts文件是下一步用FFmpeg生成的这里还没有。如果你想在后端接口中动态返回密钥需要把密钥内容传给客户端。直接传二进制不方便通常转换成Base64字符串。点击Tools - HLS - 获取密钥Base64字符串脚本会自动读取enc.key文件将其转换为Base64格式并复制到你的剪贴板你直接粘贴到你的后端代码或配置里就行。重要安全提醒enc.key是你的核心密钥绝对不能直接放在客户端安装包比如最终的APK/IPA文件里否则加密形同虚设。key_info.txt只是给FFmpeg加工视频时用的最终分发视频时不需要它。安全的做法是将enc.key文件放在你的服务器上通过一个需要授权验证的API接口来提供。Unity客户端在播放时去请求这个接口拿到密钥。我们后面会讲如何在AVPro Video里配置这个动态密钥。4. 第二步加工“录像带”——使用FFmpeg加密并切片视频钥匙准备好了接下来就要处理我们的“电影母带”原始视频了。这里我们需要请出多媒体处理领域的“瑞士军刀”——FFmpeg。别怕我们不需要成为FFmpeg专家只需要照着正确的“配方”命令使用它就行。首先安装FFmpeg去FFmpeg官网 (ffmpeg.org) 下载对应你操作系统Windows/macOS/Linux的编译好的版本。解压下载的压缩包找到里面的bin文件夹你会看到ffmpeg.exe(Windows) 或ffmpeg(macOS/Linux) 这个可执行文件。关键步骤将FFmpeg添加到系统环境变量PATH中Windows右键“此电脑”-“属性”-“高级系统设置”-“环境变量”在“系统变量”里找到Path编辑新建一条把bin文件夹的完整路径粘贴进去例如C:\ffmpeg\bin。macOS/Linux打开终端将FFmpeg的bin目录路径添加到你的shell配置文件如~/.bashrc或~/.zshrc中例如添加一行export PATH$PATH:/path/to/ffmpeg/bin然后执行source ~/.zshrc。验证安装打开命令行CMD或终端输入ffmpeg -version如果能看到版本信息说明安装成功。接下来准备加密转换假设你的原始视频文件叫my_video.mp4并且上一步生成的key_info.txt文件在C:\my_project\Assets\StreamingAssets\HLS\key_info.txt。 我们打算把输出文件加密后的.ts切片和.m3u8索引放到C:\my_project\EncryptedVideos\目录下。打开命令行切换到你的工作目录或者直接使用文件的绝对路径。下面是一个功能比较完整的FFmpeg命令示例我把它拆解开给你解释每个参数的作用ffmpeg -i C:\path\to\your\my_video.mp4 \ -c:v libx264 \ -preset slow \ -crf 23 \ -g 48 \ -sc_threshold 0 \ -profile:v high \ -level 4.2 \ -maxrate 5000k \ -bufsize 10000k \ -hls_time 6 \ -hls_list_size 0 \ -hls_segment_filename C:\my_project\EncryptedVideos\segment_%03d.ts \ -hls_key_info_file C:\my_project\Assets\StreamingAssets\HLS\key_info.txt \ -movflags faststart \ C:\my_project\EncryptedVideos\output.m3u8命令参数详解-i input.mp4 指定输入文件路径。-c:v libx264 视频编码器使用H.264libx264兼容性最好。-preset slow 编码预设slow能在保证质量的前提下提供较好的压缩率。编码越慢压缩率越高质量越好。你也可以用medium默认或fast。-crf 23 恒定质量因子范围是0-51值越小质量越高文件越大。23是公认的“透明质量”起点肉眼几乎看不出损失。你可以根据需求在18-28之间调整。-g 48 设置关键帧GOP间隔为48帧。对于HLS通常建议关键帧间隔等于或略小于切片时长-hls_time对应的帧数以确保每个切片都能从关键帧开始。-sc_threshold 0 禁止场景切换时自动插入关键帧让关键帧严格按照-g参数设置。-profile:v high -level 4.2 指定H.264的配置文件和级别high配置文件和4.2级别能支持更高的分辨率和码率兼容现代设备。-maxrate 5000k -bufsize 10000k 设置最大码率和缓冲区大小用于控制视频流的码率波动对于流媒体播放的稳定性有帮助。-hls_time 6 每个视频切片.ts文件的时长单位是秒。这里设置为6秒是HLS的常见值。-hls_list_size 0 在.m3u8播放列表中保留所有切片条目0表示无限。如果设为正数如5则列表只保留最近N个切片适合直播。-hls_segment_filename .../segment_%03d.ts 指定切片文件的命名格式和输出目录。%03d会被替换为001, 002这样的序号。-hls_key_info_file .../key_info.txt最关键的一步指定上一步我们生成的密钥配置文件路径。FFmpeg会根据这个文件找到密钥和IV并对每个.ts切片进行AES-128加密。-movflags faststart 将MP4的元数据移动到文件开头方便网络流媒体快速开始播放对最终的.ts文件本身影响不大但是个好习惯。output.m3u8 指定输出的.m3u8索引文件路径。执行完这条命令后FFmpeg会开始工作。你会看到命令行窗口滚动大量的编码信息。完成后去C:\my_project\EncryptedVideos\目录看看应该会生成一个output.m3u8文件和一堆segment_001.ts,segment_002.ts... 这样的加密视频切片文件。检查成果用文本编辑器打开output.m3u8文件你应该能看到类似这样的内容#EXTM3U #EXT-X-VERSION:3 #EXT-X-TARGETDURATION:6 #EXT-X-MEDIA-SEQUENCE:0 #EXT-X-PLAYLIST-TYPE:VOD #EXT-X-KEY:METHODAES-128,URIenc.key,IV0x1234567890abcdef1234567890abcdef #EXTINF:6.000000, segment_001.ts #EXTINF:6.000000, segment_002.ts ...注意#EXT-X-KEY这一行它指明了加密方法为AES-128密钥的URI是enc.key这就是我们之前在key_info.txt里写的第一行后面还跟着IV。这个URI非常重要播放器AVPro Video会根据这个URI去获取密钥。如果密钥放在服务器上这里的URI就应该是一个完整的URL比如https://api.yourgame.com/video/key?id123。5. 第三步在Unity中用AVPro Video播放加密流视频加密切片完成终于到了最后一步也是在Unity里见证成果的一步。首先你需要在Unity Asset Store购买并导入AVPro Video插件建议使用较新的版本如v3.x对HLS和硬件解码支持更好。基础播放设置在场景中创建一个GameObject命名为“MediaPlayer”。为其添加Media Player组件。在Media Player组件上你会看到Media Source选项。选择Media Path或Media URL。如果你把加密视频文件.m3u8和.ts放在了StreamingAssets文件夹里可以选Media Path路径填相对于StreamingAssets的路径比如HLS/output.m3u8。更常见的做法是把视频放到云存储或CDN上那就选Media URL填入完整的HTTP/HTTPS地址比如https://your-cdn.com/videos/output.m3u8。创建一个UI RawImage将Media Player组件的Video Output拖给它的Texture属性。运行游戏如果一切配置正确你应该能看到视频播放但此时可能提示解密失败或黑屏因为我们还没告诉播放器密钥在哪。配置密钥——安全的核心AVPro Video提供了几种方式来提供密钥安全性从低到高排列方法A明文密钥仅用于测试绝对不要用于正式环境在Media Player组件上找到Key或Encryption Key相关字段不同版本可能名称略有差异v3版本通常在Options折叠栏下。如果有一个Key Override或AES-128 Key的输入框你可以直接把上一步用工具生成的Base64密钥字符串粘贴进去。这种方法密钥直接暴露在客户端代码或资源中极其不安全仅供快速测试验证流程是否走通。方法B通过脚本动态设置密钥推荐这是更安全、更灵活的方式。我们通过代码在运行时为Media Player提供密钥。通常你需要一个后端API来验证用户身份后返回密钥。首先编写一个获取密钥的协程或异步方法这里以UnityWebRequest为例using UnityEngine; using UnityEngine.Networking; using RenderHeads.Media.AVProVideo; // AVPro Video的命名空间 public class HLSEncryptedVideoPlayer : MonoBehaviour { public MediaPlayer mediaPlayer; public string m3u8Url https://your-cdn.com/videos/output.m3u8; public string keyServerApiUrl https://your-server.com/api/getVideoKey?videoId123; IEnumerator Start() { if (mediaPlayer null) { mediaPlayer GetComponentMediaPlayer(); } // 1. 从你的安全服务器获取密钥 string encryptionKeyBase64 null; using (UnityWebRequest webRequest UnityWebRequest.Get(keyServerApiUrl)) { // 这里可以添加必要的请求头比如身份验证Token // webRequest.SetRequestHeader(Authorization, Bearer userToken); yield return webRequest.SendWebRequest(); if (webRequest.result UnityWebRequest.Result.Success) { encryptionKeyBase64 webRequest.downloadHandler.text.Trim(); Debug.Log(成功获取到加密密钥。); } else { Debug.LogError($获取密钥失败: {webRequest.error}); yield break; // 获取密钥失败退出播放 } } // 2. 将Base64字符串解码回字节数组 byte[] keyBytes null; try { keyBytes System.Convert.FromBase64String(encryptionKeyBase64); if (keyBytes.Length ! 16) { Debug.LogError($密钥长度错误期望16字节实际得到{keyBytes.Length}字节。); yield break; } } catch (System.FormatException) { Debug.LogError(密钥Base64字符串格式错误。); yield break; } // 3. 创建MediaPlayer的播放选项并设置密钥 MediaPath mediaPath new MediaPath(m3u8Url, MediaPathType.AbsolutePathOrURL); // 对于AVPro Video v3.x通过 MediaPlayer.Options 的 key 和 keyIsBase64 属性设置 mediaPlayer.m_Options.key encryptionKeyBase64; // 直接传入Base64字符串 mediaPlayer.m_Options.keyIsBase64 true; // 明确告知插件密钥是Base64格式 // 或者如果你有IV十六进制字符串也可以设置 // mediaPlayer.m_Options.iv 你生成的IV十六进制字符串; // 4. 打开媒体并播放 mediaPlayer.OpenMedia(mediaPath, true); // 第二个参数autoPlay设为true } }把这个脚本挂到你的MediaPlayer游戏对象上并填好m3u8Url和keyServerApiUrl。运行游戏脚本会先请求你的服务器获取密钥然后配置给AVPro Video最后才打开视频流。这样密钥在客户端内存中只是临时存在且通过HTTPS传输安全性高得多。关键优化开启硬件解码在移动设备上播放视频尤其是高清视频软件解码会非常耗电且可能卡顿。务必在Media Player组件的Options里将Allow Hardware Decoding勾选上。AVPro Video会尝试使用设备GPU进行解码能大幅提升性能和降低功耗。可能遇到的坑与排查黑屏但有声音 这通常是解密失败或密钥不匹配。请检查1) 生成密钥、加密视频、播放时提供的密钥三者是否完全一致。2) IV是否设置正确如果加密时用了IV播放时也必须提供相同的IV。3) 密钥的格式是否是原始的16字节二进制数据转换的Base64。无法播放/加载失败 检查.m3u8文件的URL是否能被正常访问可以在电脑浏览器里直接输入URL试试。检查网络权限尤其是Android和iOS需要确保应用有网络访问权限。检查CORS跨域资源共享问题如果你的视频和密钥放在不同域名下服务器需要正确配置CORS头。播放卡顿 检查视频的码率-maxrate是否设置过高超过了下行带宽。可以尝试降低码率或分辨率重新编码。确保开启了硬件解码。6. 进阶密钥轮换与更安全的部署策略对于安全要求极高的项目比如顶级IP的预告片、付费订阅内容静态的一个密钥用到底还是有风险。我们可以实现密钥轮换Key Rotation。思路是将一段长视频分成多个章节每个章节使用不同的密钥进行加密。在.m3u8文件中可以包含多个#EXT-X-KEY标签为不同的视频片段指定不同的密钥URI。制作多密钥加密视频你需要准备多个key_info.txt文件每个对应一个密钥和IV。然后使用FFmpeg的-hls_key_info_file参数但需要更复杂的脚本来控制不同时间段使用不同的密钥文件。这通常需要编写脚本分段调用FFmpeg或者使用支持密钥轮换的更高阶工具。在AVPro Video中应对密钥轮换当播放器遇到新的#EXT-X-KEY标签时它会尝试从指定的新URI获取密钥。因此你的后端密钥接口需要能够根据视频ID和时间段或章节ID来返回对应的密钥。客户端代码如上一节的HLSEncryptedVideoPlayer需要能够处理播放过程中密钥变更的事件。AVPro Video的API通常提供了相关的回调如OnMediaPlayerEvent你可以监听EventType.MetaDataReady或特定错误事件在需要时重新向服务器请求新的密钥并调用mediaPlayer.SetEncryptionKey()之类的方法进行更新具体方法请查阅你所用版本的AVPro Video文档。部署架构建议视频文件托管将加密后的.ts和.m3u8文件放在对象存储如AWS S3, 阿里云OSS或CDN上利用它们的高带宽和低成本。密钥服务器单独部署一个轻量的后端API服务如用Node.js, Python Flask/Django, Go等编写专门负责密钥分发。这个服务必须进行严格的身份验证Authentication和授权Authorization例如验证用户的登录Token、订阅状态、设备ID、播放许可证等确保只有合法用户才能拿到密钥。动态密钥URL在生成.m3u8文件时#EXT-X-KEY中的URI不要写死成enc.key而应该是一个带参数的动态API地址例如https://your-api.com/key?video_idxxxsegmentyyytokenzzz。播放器在请求每个密钥时都会携带验证信息。短期有效令牌可以考虑为每次播放会话生成一个短期有效的JWT令牌并将其作为参数附加在密钥请求的URL中。密钥服务器验证令牌有效后才返回密钥令牌过期后即使有.m3u8文件也无法获得新密钥从而控制播放时效。这套组合拳下来你的视频内容安全性就得到了极大保障。从视频源的加密切片到密钥的动态分发与验证形成了一个完整的内容保护链条。实测在多个商业项目中这套方案都非常稳定可靠既能有效防止视频被直接盗取又能给终端用户提供流畅的流式播放体验。