故障排除

用浏览器的查找功能或文档搜索，在本页找到屏幕上显示的那句话。 提示里出现片源名称的地方，本页写作片源。

片源在首页、浏览或影片详情页加载失败时，杨桃播放器会显示一个标题和下面的一行说明，然后是重试。 如果杨桃播放器自己能处理这个问题，前面还会多一个按钮：登录、编辑片源、安装插件、打开仓库或去验证。 在添加片源表单里，测试连接会把这两句话显示在同一行。

片源加载不出来

“设备已离线”

这台设备没有网络时，首页会在片源旁边这样提示。 在恢复联网之前，首页只能显示之前从片源保存下来的内容，没有保存下来的图片不会显示。 把设备重新连上 Wi-Fi 或网线即可：提示会消失，图片会加载出来，之前没能加载的首页也会自动重试。

这台设备没有网络、片源因此连不上时，首页、浏览、搜索或影片详情页也会以它为标题，下面一行是“请将这台设备连上网络后重试。” 问题不在片源：把设备重新联网，然后点重试。

“无法连接 片源”

下面一行是“请检查这台设备的网络连接后重试。”

片源完全没有响应。 确认这台设备已联网、服务器正在运行，然后点重试。 如果两者都没问题，请在设置、片源里检查片源的地址：服务器地址变了，或者地址只在家里能用，也会出现这条提示。 如果两者都没问题而且一直这样，可能是片源的插件出了问题：到设置、插件里看看有没有新版本，或者告诉插件的作者。

“片源 加载失败”

片源有响应，但返回了错误。 标题下面那行是片源自己的说明，告诉你原因；片源自己的提示里列出了这些说明。

“片源 的插件卡住了”

下面一行是“杨桃播放器已停止运行该片源的插件。请稍后重试，或检查插件或应用是否有新版本。”

读取这个片源的插件一直没有结束，杨桃播放器把它停掉了。 问题不在你的网络。 请稍后重试，在设置、关于里更新杨桃播放器，并在设置、插件里看看插件有没有新版本。

“片源 想访问一个不允许它访问的地址”

下面一行是“杨桃播放器拦下了这个请求，这不是网络问题。如果这个片源的地址是你填的，请确认它是服务器实际使用的地址；否则请检查插件是否有新版本，或告诉插件的作者。”

读取这个片源的插件请求了它没有列出的地址，或者请求了你家里网络上一个你从没填过的地址，或者服务器把它转到了这样的地址，杨桃播放器拒绝发送请求。 重试也是同样的结果。 如果片源的地址是你填的，服务器把访问转到另一个地址（反向代理，或者换了端口）也会这样：请在设置、片源里改填那个地址。 否则到设置、插件里看看插件有没有新版本，或者告诉插件的作者。

“片源 的登录已过期”

下面一行是“请在设置里重新登录。”，或者片源自己的说明。

点登录，或在设置、片源里该片源的页面重新登录。

“片源 拒绝了访问”

下面一行是“请在设置里编辑该片源，检查所填的信息。”，或者片源自己的说明。

服务器不接受片源保存的用户名、密码、密钥或令牌。 进入设置、片源，选择这个片源，再点编辑，改正它们。 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.”表示登录没问题，但这个账户看不到这个片库，需要在服务器上修改权限。

“片源 未接受登录信息”

下面一行是“请检查上方填写的信息后重试。”，或者片源自己的说明。

这条提示出现在添加片源表单里。 改正上方的用户名和密码或密钥，再点一次测试连接。 Jellyfin 和 Emby 的下面一行是“片源 拒绝了访问”里那两句英文之一，同样是指上方的这些字段。

“请在 网站 登录 片源”

这个片源需要登录，而这台设备还没有登录，或者你已经退出。 点登录。 如果下面一行是“插件能访问的网站变了，请重新登录”，说明插件更新后能访问更多网站，为安全起见，杨桃播放器丢弃了原来的登录。

“片源 需要检查”

下面一行是以下之一：

• “它的地址不是有效的网址，请在设置里编辑该片源。”
• “这个来源还缺少一些信息，请在设置里编辑它。”
• 片源自己的说明，指出哪一项填错了。

点编辑片源，改正后点保存。 插件本身就是片源时没有表单，也没有这个按钮：看看插件有没有新版本，或告诉插件的作者。

“片源 缺少插件”

下面一行是“这个片源来自插件，这台设备上还没有装。请在设置里安装后重试。”

点安装插件。 它会打开设置、插件，或这个片源所在的仓库，在那里重新安装。 安装插件需要 Pro。

“片源 的插件无法运行”

下面一行是“插件已经装在这台设备上，但杨桃播放器运行不了它，可能需要更新到新版本的应用。”

在设置、关于里更新杨桃播放器。

“片源 需要先通过 网站 的浏览器验证”

下面一行是“网站 要求确认是真人在访问，需要在这台设备上的浏览器里完成验证。”

点去验证。 这台设备上会打开该网站的浏览器页面，通过验证后会自动回到杨桃播放器。

“片源 需要你同意”

下面一行是“这个片源来自一个仓库，需要你同意后才能加载。请到 设置 › 仓库 打开该仓库，查看并允许。”

点打开仓库，看看这个仓库要求什么，信任的话就允许。

“片源 已停用”

下面一行是“请在设置里启用后重试。”

进入设置、片源，选择这个片源，点启用。 显示“已停用 · 需要 Pro”的片源，是因为免费版只能有一个你自己的片源而被停用的，见 Pro。

“观看它的来源已不在了”

下面一行是“该来源已被删除，没有地方可以打开它了。可以把它从观看记录中移除，或到其他来源里找找。”

这条观看历史属于一个你已经删除的片源。 把它从观看历史中移除，或在其他片源里搜索这部影片。

“没有找到”

下面一行是“该片源上已经没有了。”

服务器上已经删除了这部影片。 在这个片源或其他片源里重新搜索。

“出错了”

下面一行是“请重试。如果一直这样，问题出在应用本身，不是片源。”

点重试。 如果一直出现，请联系我们：这是杨桃播放器的问题。

片源自己的提示

在“片源 加载失败”“片源 拒绝了访问”或“片源 需要检查”下面，那一行是片源自己写的。 无论杨桃播放器用什么语言，这些句子都是英文。

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，或改用用户名和密码。

Plex

• “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）

• “Can’t reach this source right now. Try again later.”
• “This source returned nothing this time. Try again later.”
• “This source refused access. Try another source.”：苹果CMS 片源没有登录功能，在杨桃播放器里改什么都没用。
• “This source answered with something that can’t be read. Try another source.”：先检查 API address 和 API format（JSON 或 XML）。
• “This source doesn’t have search. Try another source.”：为这个片源关闭 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。
• “There’s no MacCMS API at this address. Check the API address.”：服务器有回应，但不是苹果CMS 接口。地址通常以 /api.php/provide/vod 结尾，从网站上重新复制一次。
• “This source points at an address Yonto Player won’t connect to. Check its API address.”或“This source’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

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://，服务器有端口的话也要写上。
• “此版本不包含该片源使用的插件（插件）”：这台设备上没有这个片源的插件。安装插件，或删除片源后重新添加。

用手机设置

这些提示出现在电视上点了用手机设置之后，显示在二维码的位置。

• “暂时无法从 account.yonto.app 获取代码”：电视没能从杨桃播放器的服务获取二维码。检查电视是否联网，然后点重试。
• “暂时连不上 account.yonto.app”：电视在等待时和服务断开了。点重试。
• “手机发来的内容无法使用”：回复和这台电视发出的表单对不上，或无法用它的二维码解开。点重试，用新的二维码重新发送表单。
• “代码已过期”：这个页面开了半小时。点获取新代码。

手机上的页面可能显示：

• “这个二维码已失效”：二维码到期了，或电视已经收到了回复。电视会自动换一个新的，扫描新的即可。
• “这个链接不完整”或“这个链接无效”：相机只打开了部分地址，或打开了别的二维码。请重新扫描电视上的二维码。
• “这个浏览器打不开表单”：用手机自带的浏览器打开链接，或更新浏览器。
• “这个表单已经发送过了”，并提示“电视已经收到了回复。如果不是你发送的，请在电视上取消。”：一个二维码只接受一次回复，它已经收到了。如果不是你发送的，看看电视：如果表单里填了不是你发送的内容，按返回键离开，不要保存，就什么都不会留下。

播放

影片播放不了时，播放器会显示“播放失败”和下面某一行，以及重试，下面另有说明的除外。 加载约 10 秒后会显示“仍在连接…”，45 秒后放弃。 行末括号里的代码是给我们排查用的，平时不用管。

• “请检查网络连接后重试。（代码）”：视频传输中断了。检查设备的网络后点重试。
• “该片源没有响应，请重试，或回到详情页换一条线路。”：视频的服务器接受了连接，却什么都没发。返回后换一条线路（如果这部影片有多条）。
• “播放卡住了，请重试，或回到详情页换一条线路。（代码）”
• “该来源无法获取本集的播放地址，请重试，或回到详情页换一条线路。”：片源没能把这一集转换成可播放的内容。这一行也可能是片源自己的说明。
• “该片目前无法播放。（代码）”：视频的服务器拒绝了请求，或已经没有这个视频。换一条线路，或稍后再试。
• “此设备无法播放该视频。（代码）”：这台设备解码不了这种视频格式。如果影片有其他线路或清晰度，换一个试试；设备上没有设置能改变这一点。
• “该视频用明文 HTTP 传输，此设备不允许播放。（代码）”：这台设备拒绝未加密的视频。换一条线路。
• “该视频所在的服务器需要来源的访问信息，但来源只允许杨桃播放器把这些信息发给它指定的网站，这台服务器不在其中。（代码）”：片源的插件不让它的登录信息发给这台服务器。换一条线路，并告诉插件的作者。
• “此应用暂时无法播放该播放源。”：这一条显示在影片名下面，按钮是详情而不是重试。点它，选另一个播放源。
• “该来源没有返回可播放的地址。”：这是片源的问题。换一条线路或换一个片源。
• “片源 已停用，请在设置里启用后重试。”
• “观看它的来源已被删除。”

插件和仓库

这些提示出现在设置、插件、从网址安装，以及设置、仓库、添加仓库里。

• “这不是有效的网址”：粘贴完整地址，以 https:// 开头。
• “无法下载”：这个地址没有响应。检查地址，并确认这台设备已联网。
• “该文件过大，不像是插件”“该文件不是插件包”：这个地址不是插件。和给你地址的人确认一下。
• “此版本无法运行该插件”：杨桃播放器读不了这个插件文件。
• “该插件需要更新版本的杨桃播放器，此版本最高支持插件协议 n”：在设置、关于里更新杨桃播放器后再安装。
• “无法把它读成仓库”：这个地址不是仓库。
• “该仓库指向你本地网络中的地址，未下载”：仓库列出的插件（或它的跳转）指向你家庭网络里的另一个地址，而不是仓库自己的地址。对于仓库，杨桃播放器只访问你亲手输入的那个家庭网络地址。请仓库的维护者把插件放在仓库旁边，或者放到互联网上。
• “链接中的 sha256 无效，未下载”“文件与链接中的 sha256 不一致，未安装”“该文件不是仓库列出的插件，未安装”“文件与仓库列表中的 sha256 不一致，未安装”：文件不是链接或仓库声明的那一个，杨桃播放器没有安装它。请联系发布者。
• “操作未成功”：杨桃播放器没能保存插件。请重试。

Pro

这些提示出现在启用 Pro，在 iPhone、iPad 上通过 App Store 购买或恢复 Pro，或给它添加邮箱时，每一步见 Pro。

• “这个密钥无效，请对照邮件检查。”：重新从邮件里复制密钥。如果你生成过新密钥，旧的就不能用了。
• “该许可证已用满设备数。请在账户页面移除一台后重试。”：见设备。
• “该许可证已退款或被撤销。”：这个密钥已经不能开通 Pro。
• “这个许可证目前没有有效内容，所以 Pro 不会开启。”：这个许可证现在什么都没有，比如期限已到。请在账户页面查看，或者使用有 Pro 的许可证密钥。同一个密钥在为电视激活的网页上会提示“这个许可证目前没有有效内容。”
• “这台设备已从许可证中移除，所以这里的 Pro 已关闭。”：它在账户页面被移除了。如果许可证还有空位，按你第一次的方式在这台设备上重新启用 Pro。
• “无法连接杨桃许可证服务，请稍后重试。”：启用 Pro 需要联网。确认这台设备已联网。
• “没有成功，请重试。”
• “你的购买正在等待批准，批准后 Pro 会自动开启。”：App Store 在等人批准这笔购买，例如家长。不需要再做什么，Pro 会自己开启。
• “这个 Apple 账户没有购买过 Pro。”：恢复购买没有找到购买记录。确认这台设备登录的是你购买时用的 Apple 账户。如果你是在我们网站买的 Pro，请改为输入邮件里的密钥。
• “无法连接 App Store，请稍后重试。”：确认这台设备已联网并登录了 App Store，再试一次。
• “杨桃许可证服务无法核实这笔购买。请试试恢复购买，或写信到 support@yonto.app。”：点恢复购买。如果还是这样，请写信给我们，附上 Apple 收据上的订单号。
• “App Store 购买的 Pro 已用满设备数。在已开启 Pro 的设备上添加邮箱，然后在账户页面移除一台，或写信到 support@yonto.app。”：在已启用 Pro 的 iPhone 或 iPad 上添加邮箱，再到账户页面移除一台设备；或写信给我们，我们帮你转。见设备。
• “请查收 you@example.com 的邮件，点击里面的链接完成。”（其中是你的地址）：打开那封邮件里的链接，完成添加。可能要等一分钟，如果没收到，请看看垃圾邮件。见添加你的邮箱。
• “这个许可证已经有邮箱了。”：用它已有的邮箱登录你的账户。如果你已经收不到那个邮箱的邮件，请写信到 support@yonto.app。
• “这看起来不像邮箱地址。”：检查地址有没有输错，再点发送链接。

更新

这些提示出现在设置、关于里。

• “检查更新失败，请确认这台设备已联网。”或“检查更新失败，请稍后重试。”
• “下载失败，请重试。”
• “杨桃播放器需要安装更新的权限。”：点打开权限设置，允许后按返回键，更新会自动继续。
• “无法打开安装程序。”：请重试。如果一直失败，从下载页面安装新版本，片源和观看记录都会保留。

锁屏

“PIN 码不正确”表示输入的四位数字不是这台设备的主 PIN 码。 见主 PIN 码，其中也写了忘记 PIN 码时怎么办。

“尝试次数过多，请在 0:30 后再试”表示连续五次输错了 PIN 码或解锁码：等提示的时间过去，之后每再错一次等待时间翻倍。

“解锁码不正确”表示解锁码输错了、已经用过，或者太旧了：在账户页面显示当前的解锁码，再输入它。

“这台设备没有解锁码，只有清除杨桃播放器的数据才能重新进入。”表示这台设备没有启用 Pro；主 PIN 码里写了怎么清除数据。

还是没解决

请写信到 support@yonto.app，并写明：

• 杨桃播放器的版本，在设置、关于里可以看到。
• 设备：电视、手机、平板还是 iPhone，以及型号。
• 片源类型：Jellyfin、Plex、Emby、MacCMS、自定义 HTTP、插件还是仓库。
• 屏幕上显示的原话，包括括号里的代码。拍一张屏幕照片也可以。

帮助与支持写明了多久能收到回复，以及如何在 GitHub 上报告问题。