电视和手机上的观看历史

每台设备各自保存自己的继续播放和观看历史，除非你开启同步：它是杨桃 Pro 的一部分，让观看历史、播放进度、待看清单和最近搜索在每台设备上保持一致。

每台设备记下什么

• 首页的继续播放：你看了一半的影片。看完的电影会离开这里；剧集则会留下，停在下一集，直到看完最后一集。来自 Jellyfin、Plex 或 Emby 服务器的片子，也会列在这里，见下文。
• 历史：在电视上是首页右上角的历史图标，在手机或平板上是首页的继续播放标题，或者设置 → 观看历史；看完的影片不在继续播放里，只有看完的影片时，就从设置进入。它打开观看历史，列出你播放过的所有影片，最近看的在前，最多保留最近的 100 部。
• 待看清单：你保存下来留待以后看的影片，可以在电视上点影片页面上的加号（+）按钮、在手机或平板上点播放按钮下方的列表图标保存，在手机或平板上也可以在搜索、浏览和首页的海报菜单里保存。它显示在首页的继续播放之后：电视上这一行的末尾是查看全部，手机或平板上点它的标题就能打开完整清单。开始播放一部影片就会把它从清单中移走（它这时已在继续播放里），删除一个片源也会移走来自它的影片。
• 最近搜索：搜索框里什么都没输入时，搜索会列出你搜过的内容，最近的在前，最多保留最近的 10 条。打开某次搜索的结果，或者按下键盘上的搜索键，这次搜索才会被记下，边打字边出结果时不算。选一条就能再搜一次。
• 每部电影、每一集你停在了哪里。影片的详情页会提供继续播放，从那里接着看。
• 在 Android 电视上，主屏幕的“接着看”也会显示你看了一半的内容（前提是你的桌面有这一栏）。

这些内容由这台设备上的所有片源共用。保存了多个片源时，继续播放和观看历史里的海报会标出所属片源的名称，方便看出它从哪里打开。

设备之间

开启同步后，在同步观看历史和播放进度的设备上：

• 在一台设备上看的内容，会出现在其他设备的观看历史和继续播放里；在另一台设备上选继续播放，会从你停下的地方接着看。
• 移除一部影片，或者清空，会在每台同步观看历史的设备上一起移除。
• 同步的内容在你的设备上加密，我们的服务器和我们都读不了（见隐私政策）。
• 不参与同步的片源，它的观看历史也只留在这台设备上。

在同步最近搜索的设备上，最近搜索的列表每台都一样：在一台设备上搜索，这条搜索会排到每台设备的最前面；移除一条，或者选择清除，每台设备上都会一起移除。两台设备上输入的同一条搜索算一条，不管大小写和空格。

不开启同步时（杨桃播放器一开始就是这样，免费版也只能这样）：

• 在电视上看，不会改变手机上的继续播放和观看历史；在手机上看，也不会改变电视上的。
• 在两台设备上添加同一台服务器，也不会把它们的观看历史连起来，但服务器上的已看标记、播放进度和“继续观看”列表在两台设备上都能看到（见下文）。
• 观看历史不会进入设备的备份和换机迁移，所以新设备是从空白开始的。
• 它也不会传给我们：你的片源、观看历史和设置都留在设备上（见隐私政策）。

不开启同步时，想在另一块屏幕上接着看一部剧，在那台设备上打开这部剧，选那一集就行。除非那台设备以前播放过这一集，否则会从头开始。

你的服务器能看到什么

对于 Jellyfin、Plex 或 Emby 服务器，杨桃播放器会读取服务器上的已看标记和播放进度，也会把你看了什么告诉服务器。

• 读取什么。 服务器认为已看的影片或某一集，会画满整条进度线；服务器记着你看到一半的，继续播放会从那里接着放。这台设备对同一集也有自己的记录时，以较新的那份为准。

• 告诉服务器什么。 播放时，杨桃播放器会告知开始播放、每十秒告知一次你所在的位置、你暂停、继续或跳转，以及你停止播放，所以服务器自己的应用和你的其他设备都能看到。没有送达的报告会被丢弃，也不会显示任何提示。

• 手动标记。 在电视上，在某一集（电影则是播放按钮）上长按确定键，可标记已看或未看；在手机或平板上则是长按。服务器也会收到通知。

• 关闭。 在片源的编辑页里，把观看进度告诉服务器默认是开的。把它关掉（比如想让杨桃播放器和官方应用并用而不动服务器），服务器就会保持原样。服务器上的记录仍然会被读取。

• 继续播放。 打开首页时，杨桃播放器会向服务器要它自己的列表，一分钟内最多要一次：Jellyfin 和 Emby 是“继续观看”，Plex 是 On Deck。这些影片会按时间从新到旧加进继续播放，所以你在手机上开始看的剧，电视上也能看到。两边都有的影片只显示一次，以你较晚看的那边为准。Emby 不提供时间，所以它的影片排在有时间的后面。Plex 的 On Deck 除了你停下的地方，还包括你正在看的剧的下一集。只有服务器有的影片，点开会进入它的页面，那里的继续播放会播服务器记着你看到的那一集（Plex 的 On Deck 则可能是下一集）。它没有移除，因为它不在观看历史里；服务器不再列出它时，它就会离开继续播放。

观看历史是杨桃播放器自己的，不是服务器的，并且从空白开始。

本机文件夹、U 盘、SMB 共享或 WebDAV 共享这类片源，根本没有服务器记录观看历史：你播放的视频会以文件名出现在观看历史和继续播放里，记在这台设备上；同步带上这个片源的话，也会出现在你的其他设备上。

移除某一部，或者全部清空

• 在电视上，在观看历史里长按确定键可以移除某一部，选顶部的清空可以全部移除。
• 在手机或平板上，每一项都有菜单，里面有详情和移除，清空在顶栏的菜单里。

想移除一条最近搜索，在电视上长按确定键，在手机、平板或 Mac 上点它的 ✕。列表下方（手机、平板或 Mac 上在标题旁边）的清除会把它们全部移除。

想把一部影片从待看清单中移走，可以在它的页面点对勾（加号或列表图标会变成对勾）；在电视上，在清单里长按确定键；在手机或平板上，用它菜单里的从待看清单中移除。

移除一部影片时，它每一集停在哪里也会一起忘掉；清空则会忘掉全部进度。更新杨桃播放器会保留观看历史；卸载它，或者清除它的数据，观看历史就没了。

你可能看到的提示

“还没有观看记录” 观看历史是空的：这台设备上还没有播放过任何内容，或者已经清空了。下面有一行说明：“你开始播放的内容会出现在这里，方便以后接着看。” 只有开启同步时，其他设备上的观看历史才会显示在这里。

“要清空全部观看历史吗？此操作无法撤销。” 选择清空时会显示。它会清空这台设备；开启同步时，也会清空每台同步观看历史的设备。

“观看它的来源已不在了” 这部影片属于你在这台设备上删除了的片源，已经没有地方可以打开它了。把它从观看历史中移除，或在其他片源里找找这部影片。

故障排查列出了应用会显示的每一条提示。

杨桃播放器本身不提供任何内容。Jellyfin、Plex 和 Emby 是其各自所有者的商标，杨桃播放器与它们没有关联，也未获其认可。