# 云映 Kodi 列表可见却不能播放：区分资料目录与真实媒体路径

语言：zh-CN
原文：[云映 Kodi 列表可见却不能播放：区分资料目录与真实媒体路径](<https://allluckly.cn/guides/icouldplay-kodi-library-playback-path/>)
中文：[中文 HTML](<https://allluckly.cn/guides/icouldplay-kodi-library-playback-path/>)
English: [English HTML](<https://allluckly.cn/en/guides/icouldplay-kodi-library-playback-path/>)
发布于: 2026-11-05T00:00:00+08:00
内容更新于: 2026-11-05T00:00:00+08:00
署名：Bison

用同一项目核对 Kodi 本机文件、可交付媒体路径与手机播放结果，避免把海报和剧集目录当成视频。

Kodi 媒体库中的标题和海报是资料，实际播放还需要取到对应媒体。因而云映能够列出项目、Kodi 电视端能够播放、手机能够取得视频，是三个需要分别验证的结果。本篇针对第一个已成功而后面失败的情况，使用一段已知本地媒体建立对照，再检查问题项目。它不教绕过插件授权、提取受保护内容或把 Kodi 变成通用转码服务器；原有文件与观看记录都应保留。

## 用一部确定的媒体固定问题

选择一部你有权使用、故障能重复出现的项目，写下片名、年份、时长与 Kodi 中的媒体类型。若选中电视节目总页，先进入具体季度和某一集；总页是集合，不是那一集的视频。不要同时用三部同名不同版影片试验，否则每次失败可能来自不同路径。先保留云映中看得到的项目资料，再记失败发生在点击后立刻、出现画面后还是定位时。这样的记录把目录问题与传输问题分开，也避免为了找答案先更改匹配信息，使原来项目身份更难确认。

## 回 Kodi 本机核对原件仍在

在 Kodi 主机直接打开同一项目，确认不是海报仍在而文件已被移动或断开。若原文件位于外置盘或 NAS，检查该来源当前是否已连接，并只对许可样本进行播放；不要为排查把整个私人共享的权限改宽。Kodi 本机也失败时，先修复它能访问自己的文件这一层，再回到手机。Kodi 本机成功仍只代表主机能读取，不能证明手机可以直接访问主机内部磁盘路径。记录来源的大类即可，公开求助时无需提供完整文件夹结构或真实主机名。

## 用普通本地文件建立交付对照

找一段已经纳入 Kodi 库的普通自制视频，来源尽量是主机可正常读取的本地文件。用云映播放它，检查开头和中间锚点。这个样本成功而问题项目失败时，已有证据说明基本连接和至少一种文件交付可用，不应立刻重新填写所有服务器字段。如果连对照也失败，优先检查共同的 HTTP 服务与文件交付条件。样本不需要很长，也不需要复制正式影片；目标是减少插件、远端挂载和复杂格式这些同时变化的因素，让一次对照能解释一个差异。

## 理解媒体路径需要由服务交付

Kodi 保存的文件位置可能是主机盘符、网络共享或其他来源标识，不能直接把这些文字粘进手机浏览器当作视频网址。Kodi 的 [JSON-RPC 官方说明](<https://kodi.wiki/view/JSON-RPC_API>)把资料请求与准备下载分开，客户端还需要服务返回支持的交付方式。这里的说明用于理解边界，不要求读者手工调用接口或复制认证头。若云映提示当前来源无法直接播放，就保留这个结果；不要把路径前缀随意替换成 HTTP，文字改写不会使原本不可交付的文件自动成为可访问流。

## 把插件项目与普通文件分开

有些项目依赖 Kodi 插件、登录会话或特殊播放指令，即使电视端能播，也不一定能交给另一播放器。指向内容的文字小文件也不等于视频本身；不要把文件扩展名改成 MP4 来试图改变性质。先问这个项目是否确实对应一份可授权访问的普通媒体，再判断云映当前路径是否支持它。无法确认时换用已知许可本地样本，不索取别人会话、令牌或受限链接。把不支持的来源类型记为边界，比把所有失败都归为手机解码能力差更能帮助下一次选择合适入口。

## 已有画面时再检查播放兼容

如果已经能出现正确画面和声音，之后才在某段失败，问题与完全取不到媒体不同。记录失败时间、是否每次同一内容、定位前后是否变化，再按播放兼容教程用同一文件逐项观察。不要一边换引擎一边更换文件来源，否则无法判断哪个条件影响结果。若只在某个远程挂载失败，可请管理员确认 Kodi 对该文件的读取稳定性；若所有来源同一编码样本都失败，再保留格式方向的证据。海报、缓冲提示或转圈本身不能证明文件已经完整传到手机。

## 把连接与播放证据交给管理员

整理一张简表，列出普通本地样本和问题项目在 Kodi 本机、云映列表、云映播放三列的结果。用成功、失败、未测试区分，不用一个正常覆盖全部阶段。附当前应用版本、Kodi 版本、使用网络和失败时机，隐藏凭据、私人路径与签名链接。管理员若调整了文件位置或服务设置，先用原来的两个样本重新核对，不加入新的大片混淆结果。不要为收集证据主动清除整库或删除观看历史，保留可恢复的现场通常更方便定位真正的变化。

## 按实际边界选择后续观看方式

最终若普通文件可以交付，就保留这条已验证路径；问题项目需依赖其他环境时，如实注明当前不能通过该路径观看。对于你拥有的普通文件，可以另按已经授权的 SMB 或本地导入方式建立独立对照，不把新入口的进度当作 Kodi 进度自动合并。比较完成后恢复练习位置，保留原件和两份结果。目标是知道哪个阶段可用、哪个来源需要另处理，而不是通过不断重命名、重扫和放宽权限，让一次偶然播放掩盖了尚未解释的访问条件。

## 相关教程与资料

[连接 Kodi](<https://allluckly.cn/guides/icouldplay-kodi-http-library-setup/>)、[播放兼容排查](<https://allluckly.cn/guides/icouldplay-player-engine/>)。

资料核对：2026 年 11 月 5 日，依据 [云映官方 App Store 说明](<https://apps.apple.com/cn/app/id6755653178>)与 [Apple 公开版本查询](<https://itunes.apple.com/lookup?id=6755653178&country=cn>)，当前版本 1.1.1，最低要求 iOS / iPadOS 15.0。1.1.1 的公开更新列出 Kodi、OpenList / AList 与 S3 兼容存储，并改进来源切换及跳转后的字幕显示；本文按这些公开范围与现有播放能力组织任务，具体入口以安装版本为准。自制样本、手工记录与外部文件整理不是应用新增自动功能；未声称已完成真机或私人服务器实测。