先分清：是“看不到文件”，还是“看到了打不开”

排查之前先把现象说准确，因为两种情况的原因几乎不重叠。一种是App的选择器里根本没有你的视频，或者只有几张旧照片，这是权限或存储位置的问题。另一种是视频缩略图能看到，点进去却提示无法解析、导入后黑屏、只有声音没有画面，这是文件格式的问题。还有第三种介于两者之间：导入成功，但分析时间轴对不上，这多半与可变帧率或旋转信息有关。

下面的场景都是帮助理解排查顺序的模拟示例，不代表某个真实用户的记录。假设一位业余篮球队的记录员，用手机横屏拍了一场四节比赛，回到家在半岛体育App里选视频，选择器只显示最近几天的内容。这一现象指向权限，不需要先怀疑视频本身。

常见现象、原因与处理对照

现象 更可能的原因 先做的处理
选择器为空或只有少量照片 相册权限被限制为“部分”或“所选照片” 在系统设置里改为允许访问全部视频，或重新选择需要的视频
视频在系统相册里，但App里找不到 视频存放在微信、网盘等其他App的私有目录先保存到系统相册或文件管理器的公共目录，再导入
导入后黑屏、只有声音 H.265等编码在当前设备解码受限，或分辨率与码率过高 用系统播放器先确认能播放，再转成H.264加MP4
画面正常但没有解说和现场声音 麦克风或音轨相关授权、或视频本身无音轨检查原视频音轨，确认App没有被禁止访问音频
分析结果的时间点与画面错位 可变帧率视频，或旋转标记处理不一致 转成固定帧率后重新导入
竖屏视频被横过来拍摄时带旋转标记而不是真实像素旋转 用剪辑工具导出时写入真实方向

Android：按这个顺序检查

  1. 打开系统设置里该App的权限页，查看“照片和视频”或“文件和媒体”一项。很多系统会提供“始终允许”“仅本次允许”“部分允许”几种选项，选成后两者时，App重启后可能又看不到内容。
  2. 如果App提示要选择文件，再确认是否通过系统文件选择器授权了具体目录。不同厂商的系统界面文案差别较大，建议以设备当前的设置页说明为准。
  3. 录制类功能才需要摄像头，分析已拍好的视频并不需要。如果你只是导入录像，没有必要打开摄像头权限，但麦克风相关授权会影响音频分析和解说素材的处理。
  4. 检查剩余存储空间。导入时App需要生成临时缓存，一段较长的高码率视频在空间不足时会静默失败，这一点在第四节还会讲。
  5. 把该视频用系统自带播放器播一遍，能正常播放再回到App导入。播放器都放不了的文件，问题不在权限。

iOS：几个容易被忽略的位置

iOS对相册的授权更细。首次访问时系统会问你允许全部照片，还是只允许选中的照片。选了后者，选择器里就只能看到你手动勾选过的内容，之后拍的新视频不会自动出现，需要在设置里追加或改成完整访问。这是最常被当成“App读不到视频”的一种情形。

另一个问题是视频存放位置。存在“文件”App里的视频、来自云盘的视频，可能只是占位状态，尚未真正下载到本机。此时导入会卡住或失败，先在文件里确认已经下载完成。iPhone拍摄的视频常见组合是H.265编码加MOV容器，本机播放没有问题，但在其他工具链里可能遇到兼容差异，出现导入失败时可以先在系统里导出为兼容性更高的格式。至于App的系统版本要求，建议以下载页当前标注的系统要求为准。

移动网页：浏览器里的限制更多

通过手机浏览器使用网页版时，权限由浏览器与站点共同决定。选择文件时，浏览器会弹出系统选择器，如果你此前点过“拒绝”，需要到浏览器的站点设置里恢复。网页环境对大文件更敏感：浏览器内存有限，标签页在后台被系统回收后，上传进度可能丢失。更稳妥的做法是先在前台完成选择和上传，过程中不切换应用，长视频优先使用App而不是网页。

网页端也无法读取所有目录，只能拿到你主动选择的那个文件。如果一次要处理多个片段，请分批选择。

视频格式：哪些参数真的会影响导入

编码与容器

H.264加MP4是兼容面最广的组合，几乎所有手机和播放器都能处理。H.265压缩效率更高，同样画质文件更小，但部分旧设备只能软件解码或干脆不支持，表现为黑屏、卡顿或导入失败。MOV是苹果常用的容器，内部同样可以装H.264或H.265，容器本身通常不是问题，真正决定能否解码的是里面的编码。

可变帧率与竖屏

手机为了省电和适应光线，常常录成可变帧率：快动作时多拍几帧，静止时少拍。剪辑和分析工具按固定间隔取帧时，就可能出现时间轴漂移，事件时间点比实际晚或早一小段。竖屏视频则要看方向信息是记在文件标记里，还是真正旋转了像素，处理不一致时会出现画面横躺。

分辨率与码率

比赛录像不是越清晰越好。远距离拍摄的全场画面，球员在画面里本来就小，提高到极高码率并不能等比例提升识别效果，反而拖慢上传和解码。一般的做法是保持原始分辨率不做无意义放大，把码率控制在合理范围内，具体上传相关的取舍可以参考上传长视频很慢怎么办。

转码前先做的三件事

  • 保留原文件，转码只在副本上进行，避免转出问题后无法回退。
  • 转码时选择固定帧率，帧率与原视频主要帧率保持一致，不要为了“更流畅”强行拉高。
  • 转码后对比时长：原视频与副本相差超过几秒，说明转码过程中丢失了片段，需要重来。

转码本身也会消耗电量和存储，长视频建议接通电源并预留足够空间。这些是通用建议，具体设置以你使用的转码工具说明为准。

一个失败案例与系统的诚实边界

再看一个模拟示例：某场足球比赛的录像用手机录了整整两小时，成片是H.265、可变帧率、竖屏，并且中途因为存储空间不足自动停录又续录，合成了两个文件。导入半岛体育App后，第一个文件可以分析，第二个文件的进球片段时间点整体偏晚几秒。原因不是模型看错了，而是可变帧率加拼接造成的时间戳不连续，事件被正确识别，却被放在了错误的时间位置上。

需要说明的是，App对格式问题的处理属于持续改进的方向，并不能保证任何格式都完美兼容。遇到无法解析的文件时，更稳妥的做法是先按上面的步骤转成H.264加MP4、固定帧率再重试。整体使用流程可以对照手机视频自动识别关键片段一文，了解导入之后系统会怎样处理你的视频。

一份可以直接照做的排查顺序

  1. 确认现象：选不到文件，还是选到了打不开。
  2. 系统设置里检查照片、文件、麦克风授权，避免“仅本次”和“部分照片”。
  3. 用系统播放器验证视频本身能正常播放且有声音。
  4. 检查剩余存储空间，长视频为缓存预留余量。
  5. 转成H.264加MP4、固定帧率，保持方向为真实像素方向。
  6. 仍无法解决时，记录设备型号、系统版本和文件大小，再联系官方支持。