TextSecure项目中大视频发送失败问题分析与解决方案

问题背景

在TextSecure项目(现Signal)的7.30.1版本中，开发者发现了一个关于大视频文件发送的功能性问题。当用户尝试发送较大尺寸的视频文件并选择HD质量时，系统会自动尝试对视频进行裁剪以符合大小限制，但最终仍会抛出UndeliverableMessageException异常，导致发送失败。

问题现象

具体表现为：

1. 用户选择发送一个大尺寸视频文件
2. 选择HD质量选项
3. 系统自动对视频进行裁剪处理
4. 处理后的视频仍超出大小限制
5. 发送操作失败并抛出UndeliverableMessageException

技术分析

根本原因

经过代码分析，发现问题出在视频处理流程中的两个关键环节：

1. 自动裁剪机制：系统检测到大视频时会自动进行裁剪，但裁剪后的尺寸计算逻辑存在缺陷，未能正确更新处理后视频的实际大小信息。

2. 大小限制验证：系统在最终发送前会进行大小验证，但由于裁剪后的视频尺寸信息未正确更新，导致验证时仍使用原始视频的尺寸数据，从而误判为超出限制。

流程缺陷

视频发送的完整流程应该是：

1. 选择视频文件
2. 进行质量设置(如选择HD)
3. 系统检查文件大小
4. 若超出限制则进行自动裁剪
5. 更新裁剪后的文件信息
6. 再次验证大小
7. 通过则发送，否则提示用户

当前实现中缺少了第5步的关键操作，导致流程中断。

解决方案

针对这一问题，开发团队提出了以下修复方案：

1. 完善裁剪后处理：在视频自动裁剪完成后，立即更新文件的大小信息，确保后续验证使用正确的数据。

2. 增加用户提示：当系统自动进行视频裁剪时，向用户显示提示信息，告知视频已被调整以适应发送限制。

3. 优化异常处理：改进异常抛出机制，在视频处理阶段就捕获潜在问题，而不是等到发送阶段才失败。

实现细节

在代码层面，主要修改了视频处理模块的以下部分：

1. 在MediaUtil类中增加了裁剪后文件信息的更新逻辑
2. 修改了AttachmentManager中的大小验证流程
3. 添加了用户提示的Toast通知
4. 优化了异常处理链

用户体验改进

除了修复核心问题外，此次修改还带来了以下用户体验提升：

1. 透明性：用户现在能明确知道系统何时对视频进行了自动处理
2. 可预测性：发送失败的情况减少，操作结果更加可预测
3. 友好性：通过提示信息让用户理解系统行为，减少困惑

总结

TextSecure项目中的这一修复不仅解决了大视频发送失败的技术问题，还体现了良好的用户体验设计原则。通过正确处理文件裁剪后的元数据更新，并增加必要的用户提示，使得功能更加完善可靠。这一案例也展示了在多媒体处理流程中，数据一致性和用户反馈的重要性。