故障排除
用浏览器的查找功能或文档搜索，在本页找到屏幕上显示的那句话。 提示里出现片源名称的地方，本页写作片源。
片源在首页、浏览或影片详情页加载失败时，杨桃会显示一个标题和下面的一行说明，然后是重试。 如果杨桃自己能处理这个问题，前面还会多一个按钮：登录、编辑片源、安装插件、打开仓库或去验证。 在添加片源表单里，测试连接会把这两句话显示在同一行。
片源加载不出来
Section titled “片源加载不出来”“设备已离线”
Section titled ““设备已离线””这台设备没有网络时，首页会在片源旁边这样提示。 在恢复联网之前，首页只能显示之前从片源保存下来的内容，没有保存下来的图片不会显示。 把设备重新连上 Wi-Fi 或网线即可：提示会消失，图片会加载出来，之前没能加载的首页也会自动重试。
“无法连接 片源”
Section titled ““无法连接 片源””下面一行是“请检查这台设备的网络连接后重试。”
片源完全没有响应。 确认这台设备已联网、服务器正在运行，然后点重试。 如果两者都没问题，请在设置、片源里检查片源的地址：服务器地址变了，或者地址只在家里能用，也会出现这条提示。 杨桃拒绝向该片源不允许访问的地址发送请求时，也会这样提示。 所以如果设备已联网、地址也没错，可能是片源的插件在请求它不能访问的地址：到设置、插件里看看有没有新版本，或者告诉插件的作者。
“片源 加载失败”
Section titled ““片源 加载失败””片源有响应，但返回了错误。 标题下面那行是片源自己的说明，告诉你原因；片源自己的提示里列出了这些说明。
“片源 的插件卡住了”
Section titled ““片源 的插件卡住了””下面一行是“杨桃已停止运行该片源的插件。请稍后重试，或检查插件或应用是否有新版本。”
读取这个片源的插件一直没有结束，杨桃把它停掉了。 问题不在你的网络。 请稍后重试，在设置、关于里更新杨桃，并在设置、插件里看看插件有没有新版本。
“片源 的登录已过期”
Section titled ““片源 的登录已过期””下面一行是“请在设置里重新登录。”，或者片源自己的说明。
点登录，或在设置、片源里该片源的页面重新登录。
“片源 拒绝了访问”
Section titled ““片源 拒绝了访问””下面一行是“请在设置里编辑该片源，检查所填的信息。”，或者片源自己的说明。
服务器不接受片源保存的用户名、密码、密钥或令牌。 进入设置、片源，选择这个片源，再点编辑，改正它们。 Jellyfin 和 Emby 会说明是哪一项（这些说明是英文）：“Check the username and password by editing the source in Settings.”或“Check the API key and user id by editing the source in Settings.” “Check this account’s permissions on the server.”表示登录没问题，但这个账户看不到这个片库，需要在服务器上修改权限。
“片源 未接受登录信息”
Section titled ““片源 未接受登录信息””下面一行是“请检查上方填写的信息后重试。”，或者片源自己的说明。
这条提示出现在添加片源表单里。 改正上方的用户名和密码或密钥，再点一次测试连接。 Jellyfin 和 Emby 的下面一行是“片源 拒绝了访问”里那两句英文之一，同样是指上方的这些字段。
“请在 网站 登录 片源”
Section titled ““请在 网站 登录 片源””这个片源需要登录，而这台设备还没有登录，或者你已经退出。 点登录。 如果下面一行是“插件能访问的网站变了，请重新登录”，说明插件更新后能访问更多网站，为安全起见，杨桃丢弃了原来的登录。
“片源 需要检查”
Section titled ““片源 需要检查””下面一行是以下之一：
- “它的地址不是有效的网址，请在设置里编辑该片源。”
- “这个来源还缺少一些信息，请在设置里编辑它。”
- 片源自己的说明，指出哪一项填错了。
点编辑片源，改正后点保存。 插件本身就是片源时没有表单，也没有这个按钮：看看插件有没有新版本，或告诉插件的作者。
“片源 缺少插件”
Section titled ““片源 缺少插件””下面一行是“这个片源来自插件，这台设备上还没有装。请在设置里安装后重试。”
点安装插件。 它会打开设置、插件，或这个片源所在的仓库，在那里重新安装。 安装插件需要 Pro。
“片源 的插件无法运行”
Section titled ““片源 的插件无法运行””下面一行是“插件已经装在这台设备上，但 杨桃运行不了它，可能需要更新到新版本的应用。”
在设置、关于里更新杨桃。
“片源 需要先通过 网站 的浏览器验证”
Section titled ““片源 需要先通过 网站 的浏览器验证””下面一行是“网站 要求确认是真人在访问，需要在这台设备上的浏览器里完成验证。”
点去验证。 这台设备上会打开该网站的浏览器页面，通过验证后会自动回到杨桃。
“片源 需要你同意”
Section titled ““片源 需要你同意””下面一行是“这个片源来自一个仓库，需要你同意后才能加载。请到 设置 › 仓库 打开该仓库，查看并允许。”
点打开仓库，看看这个仓库要求什么，信任的话就允许。
“片源 已停用”
Section titled ““片源 已停用””下面一行是“请在设置里启用后重试。”
进入设置、片源，选择这个片源，点启用。 显示“已停用 · 需要 Pro”的片源，是因为免费版只能有一个你自己的片源而被停用的，见 Pro。
“观看它的来源已不在了”
Section titled ““观看它的来源已不在了””下面一行是“该来源已被删除，没有地方可以打开它了。可以把它从观看记录中移除，或到其他来源里找找。”
这条观看历史属于一个你已经删除的片源。 把它从观看历史中移除，或在其他片源里搜索这部影片。
“没有找到”
Section titled ““没有找到””下面一行是“该片源上已经没有了。”
服务器上已经删除了这部影片。 在这个片源或其他片源里重新搜索。
下面一行是“请重试。如果一直这样，问题出在应用本身，不是片源。”
点重试。 如果一直出现，请联系我们：这是杨桃的问题。
片源自己的提示
Section titled “片源自己的提示”在“片源 加载失败”“片源 拒绝了访问”或“片源 需要检查”下面，那一行是片源自己写的。 无论杨桃用什么语言，这些句子都是英文。
Jellyfin 和 Emby
Section titled “Jellyfin 和 Emby”- “The server did not answer.”（Emby）：确认服务器正在运行，Server URL 填写正确。
- “The server answered with an error.”：服务器出错了。稍后重试，并查看服务器自己的日志。
- “The server answered with a page that is not the media server: check the server URL.”：这个地址打开的是别的网页。改正 Server URL，包括端口。
- “Signing in failed: the server answered with an error.”或“Signing in failed: the server accepted the sign-in but sent back no session.”：服务器在登录时出错。稍后重试，并查看服务器的日志。
- “This source has no credentials: fill in a username and password, or an API key and user id.”：编辑片源，把它们填上。
- “This source has an API key but no user id: fill that in, or use a username and password instead.”：编辑片源，补上 User id，或改用用户名和密码。
- “Log in to Plex, or type your own server’s address, by editing the source in Settings.”：编辑片源，点账户旁的登录，或填写你服务器的网址。
- “The list of your Plex servers could not be read.”：plex.tv 没有响应。确认这台设备已联网后重试。
- “No Plex server is shared with this account. For your own server, add its address and token by editing the source in Settings.”：你登录的账户下没有服务器。改用拥有或共享该服务器的账户登录，或填写你服务器的网址和令牌。
- “The server did not answer. Check it is running and on this network.”：确认服务器已开启，且这台设备能访问到它。
- “None of the server’s addresses answered.”：Plex 记录的这台服务器的所有地址都没有响应。确认它正在运行，或填写一个这台设备能访问的地址。
- “The server refused this login. Try again in a minute.”
- “The server refused the token. Check it by editing the source in Settings.”或“The server asks for a Plex token. Add one by editing the source in Settings.”：编辑片源，改正 Plex 令牌。
- “The server URL cannot be used. Check it by editing the source in Settings.”或“The server redirected too far. Check the server URL by editing the source in Settings.”：改正网址。
- “The server sent this request somewhere it may not go.”：服务器把请求重定向到了这个片源不允许访问的地址。检查服务器自己的地址设置。
- “The server answered with something that is not a Plex library.”：这个地址打开的是别的东西。改正网址。
- “The server answered with an error.”：稍后重试，并查看服务器的日志。
- “This search cannot be sent. Try different words.”
- “The server has no playable file for this title.”
苹果CMS（MacCMS）
Section titled “苹果CMS（MacCMS）”- “Can’t reach this catalog right now. Try again later.”
- “This catalog returned nothing this time. Try again later.”
- “This catalog refused access. Try another catalog.”：苹果CMS 片库没有登录功能，在杨桃里改什么都没用。
- “This catalog answered with something that can’t be read. Try another catalog.”：先检查 API address 和 API format（JSON 或 XML）。
- “This catalog doesn’t have search. Try another catalog.”：为这个片源关闭 Supports search，或在其他片源里搜索。
- “This search can’t be sent. Try different words.”
- “The API address must start with http:// or https://.”或“The API address can’t be used. Check it.”：改正 API address。
- “This catalog points at an address Yonto won’t connect to. Check its API address.”或“This catalog’s redirects lead nowhere. Check its API address.”
- “This address is a repo of many sites, not a single MacCMS API. Add it under Repos instead.”：在设置、仓库、添加仓库里添加它，见插件和仓库。
- ““影片名” has nothing to play.”：片库列出了这部影片，但没有可播放的地址。换一个片源试试。
XPTV 片源是一个小程序，杨桃在打开片源时从它的 Program address 下载。
- “Can’t download this source’s program right now. Try again later.”：程序下载不下来：它的地址没有响应，或返回了错误或空内容。稍后重试，或换一个片源。
- “This source’s program is too large to load.”：等待也不会变。换一个片源试试。
- “This source’s program won’t run. It may be out of date.”：程序出错了，通常是因为它读取的网站改版了。换一个片源试试。
- “This source’s website isn’t available right now. Try again later.”
- “This source has no categories to browse. Use search instead.”：片源没有问题，它只能搜索。
- “This source doesn’t have search. Try another source.”
- “This source gave no address to play.”：换一条线路，或换一个片源。
- “The program address isn’t a full http(s) address. Check it.”：改正 Program address。
- ““影片名” has nothing to play.”：片源列出了这部影片，但没有可播放的地址。换一个片源试试。
- ““影片名” can’t be played in this version yet, only browsed.”：这部影片只有杨桃暂时还不能播放的链接。换一个片源试试。
这些提示出现在添加片源表单的测试连接或保存下方。
- “连接成功”：片源可以用了，点保存。
- “请先填写所有字段”或“请先填写字段”：片源需要的某个字段还空着。
- “请输入完整地址，例如 https://example.com:8096”或“*字段* 请输入完整地址，例如 https://example.com:8096”：要包括
http://或https://，服务器有端口的话也要写上。 - “此版本不包含该片源使用的插件（插件）”：这台设备上没有这个片源的插件。安装插件，或删除片源后重新添加。
影片播放不了时，播放器会显示“播放失败”和下面某一行，以及重试，下面另有说明的除外。 加载约 10 秒后会显示“仍在连接…”，45 秒后放弃。 行末括号里的代码是给我们排查用的，平时不用管。
- “请检查网络连接后重试。（代码）”：视频流中断了。检查设备的网络后点重试。
- “该片源没有响应，请重试，或回到详情页换一条线路。”：视频流的服务器接受了连接，却什么都没发。返回后换一条线路（如果这部影片有多条）。
- “播放卡住了，请重试，或回到详情页换一条线路。（代码）”
- “该来源无法获取本集的播放地址，请重试，或回到详情页换一条线路。”：片源没能把这一集转换成视频流。这一行也可能是片源自己的说明。
- “该片目前无法播放。（代码）”：视频流的服务器拒绝了请求，或已经没有这个视频。换一条线路，或稍后再试。
- “此设备无法播放该视频。（代码）”：这台设备解码不了这种视频格式。如果影片有其他线路或清晰度，换一个试试；设备上没有设置能改变这一点。
- “该视频用明文 HTTP 传输，此设备不允许播放。（代码）”：这台设备拒绝未加密的视频流。换一条线路。
- “该视频所在的服务器需要来源的访问信息，但来源只允许 杨桃把这些信息发给它指定的网站，这台服务器不在其中。（代码）”：片源的插件不让它的登录信息发给这台服务器。换一条线路，并告诉插件的作者。
- “此应用暂时无法播放该播放源。”：这一条显示在影片名下面，按钮是详情而不是重试。点它，选另一个播放源。
- “该来源没有返回可播放的地址。”：这是片源的问题。换一条线路或换一个片源。
- “片源 已停用，请在设置里启用后重试。”
- “观看它的来源已被删除。”
这些提示出现在设置、插件、从网址安装，以及设置、仓库、添加仓库里。
- “这不是有效的网址”：粘贴完整地址，以
https://开头。 - “无法下载”：这个地址没有响应。检查地址，并确认这台设备已联网。
- “该文件过大，不像是插件”“该文件不是插件包”：这个地址不是插件。和给你地址的人确认一下。
- “此版本无法运行该插件”：杨桃读不了这个插件文件。
- “该插件需要更新版本的 杨桃，此版本最高支持插件协议 n”：在设置、关于里更新杨桃后再安装。
- “无法把它读成仓库”：这个地址不是仓库。
- “该仓库指向你本地网络中的地址，未下载”：仓库列出的插件（或它的跳转）指向你家庭网络里的另一个地址，而不是仓库自己的地址。对于仓库，杨桃只访问你亲手输入的那个家庭网络地址。请仓库的维护者把插件放在仓库旁边，或者放到互联网上。
- “链接中的 sha256 无效，未下载”“文件与链接中的 sha256 不一致，未安装”“该文件不是仓库列出的插件，未安装”“文件与仓库列表中的 sha256 不一致，未安装”：文件不是链接或仓库声明的那一个，杨桃没有安装它。请联系发布者。
- “操作未成功”：杨桃没能保存插件。请重试。
- “安装插件需要杨桃 Pro。已安装的插件仍可更新。”：见 Pro。
这些提示出现在启用 Pro 时，每一步见 Pro。
- “这个密钥无效，请对照邮件检查。”：重新从邮件里复制密钥。如果你生成过新密钥，旧的就不能用了。
- “该许可证已用满设备数。请在账户页面移除一台后重试。”：见设备。
- “该许可证已退款或被撤销。”：这个密钥已经不能开通 Pro。
- “无法连接杨桃许可证服务，请稍后重试。”：启用 Pro 需要联网。确认这台设备已联网。
- “没有成功，请重试。”
这些提示出现在设置、关于里。
- “检查更新失败，请确认这台设备已联网。”或“检查更新失败，请稍后重试。”
- “下载失败，请重试。”
- “杨桃需要安装更新的权限。”：点打开权限设置，允许后按返回键，更新会自动继续。
- “无法打开安装程序。”：请重试。如果一直失败，从下载页面安装新版本，片源和观看记录都会保留。
“PIN 码不正确”表示输入的四位数字不是这台设备的主 PIN 码。 见主 PIN 码，其中也写了忘记 PIN 码时怎么办。
“尝试次数过多，请在 0:30 后再试”表示连续五次输错了 PIN 码或解锁码：等提示的时间过去，之后每再错一次等待时间翻倍。
“解锁码不正确”表示解锁码输错了、已经用过，或者太旧了：在账户页面显示当前的解锁码，再输入它。
“这台设备没有解锁码，只有清除杨桃的数据才能重新进入。”表示这台设备没有启用 Pro；主 PIN 码里写了怎么清除数据。
请写信到 support@yonto.app，并写明：
- 杨桃的版本，在设置、关于里可以看到。
- 设备：电视、手机、平板还是 iPhone，以及型号。
- 片源类型：Jellyfin、Plex、Emby、MacCMS、自定义 HTTP、插件还是仓库。
- 屏幕上显示的原话，包括括号里的代码。拍一张屏幕照片也可以。
帮助与支持写明了多久能收到回复，以及如何在 GitHub 上报告问题。