文档

加入测试，连上你的音乐，在 Yoin 里认认路。

开始使用加入封闭测试

1. 用手机上登录的那个 Google 账号加入测试群组。
2. 在 Google Play 打开测试页面，轻点成为测试人员。
3. 从 Google Play 安装 Yoin。加入测试后，Yoin 可能要过几分钟才会出现。

需要准备什么

• 一台 Android 8.0 或更高版本的手机、平板或折叠屏，能连上网络。
• 以下至少一项：
  • 兼容 Subsonic 的服务器，比如 Navidrome 或 Gonic，外加用户名和密码。
  • Spotify Premium，并在同一台设备上装好 Spotify 应用、登录账号。
  • Apple Music 订阅。
• 可选：Gemini API 密钥，用于歌曲信息、问 Gemini、歌词翻译和 Memories 标题。

首次启动

第一次打开 Yoin 时，会有一段简短的引导帮你设置好。

1. 轻点开始，选出你平时听歌用的服务，可以多选。还没添加任何账号时，至少要选一项。
2. Yoin 会说明自己负责哪些事，以及各项服务需要你准备什么。轻点下一步。
3. 逐个连接选好的服务。想晚点再弄，就轻点跳过，之后在设置 › 账号里添加。
4. 决定首页上放些什么：拖移分区调整顺序，把不想要的隐藏掉。之后在首页长按，还能改每个分区显示几行。
5. 选择滚动时内容怎样移入顶栏下方：潮线、网点或曲奇浪口。轻点一种就能预览。
6. 轻点进入 Yoin。底部的按钮会直接变成首页的底栏。

想再走一遍，打开设置 › 关于 › 欢迎向导。已添加的账号和数据都会原样保留，选择服务那一步可以直接跳过。

账号Subsonic 和 Navidrome

Navidrome、Gonic、Airsonic，以及其他支持 Subsonic 或 OpenSubsonic API 的服务器，Yoin 都能连。你需要服务器地址，以及你在上面的用户名和密码。

1. 在设置 › 账号里轻点添加账号，选择 Subsonic。欢迎向导里也是同一张表单。
2. 填入服务器地址，带上 http:// 或 https://，有端口号的也要写上，比如 https://music.example.com。再填用户名和密码。
3. 轻点连接。Yoin 会检查服务器和登录信息，通过后保存账号并切换过去。检查没通过的话，填好的内容会留在表单里。

需要留意

• 手机必须能访问这个地址。填的是家里局域网的地址，出门在外就得借助 VPN 或内网穿透。
• Yoin 里的心形，就是服务器上的星标，歌曲、专辑和艺术家都一样。
• 歌曲评分也会同步到服务器（前提是服务器支持评分），换算成 0 到 5 星：你的分数除以 2 再四舍五入。Yoin 自己保留一位小数，比如 8.6。
• 能不能编辑某个播放列表，取决于它在服务器上归谁所有。
• 音频由服务器提供，服务器可能会转码，所以实际播放的格式不一定和资料库里的文件相同。
• 密码加密保存在你的手机上。要改地址或密码，到设置 › 账号里轻点该账号上的管理。

Spotify

你需要 Spotify Premium，并在同一台设备上用同一个账号登录 Spotify 应用。Yoin 通过 Spotify 的 Web API 读取资料库、搜索、点赞歌曲和编辑播放列表，通过 Spotify 应用播放音乐。

Spotify 要求每个应用都用 Client ID 表明身份，所以得你自己建一个。免费，大约五分钟。Yoin 会在浏览器上方浮出一个小向导，每项要填的值都有复制按钮，不用在两个应用之间来回切换。

1. 在 Yoin 的 Spotify 页面轻点打开 Spotify for Developers。浏览器打开后，Yoin 会缩成浮在上方的小向导。你也可以自己打开 Spotify for Developers。
2. 用你的 Spotify 账号登录，轻点 Create app。名称和描述随便填，比如 Yoin。
3. 在 Redirect URIs 下逐个添加这两个地址，每加一个都轻点一次 Add：
   yoin://auth/spotify/callback复制
   yoin://auth/spotify/app-remote复制
4. 勾选 Web API 和 Android。
5. 在 Android packages 下填入包名，以及向导显示的 SHA1 指纹，然后轻点 Add。请使用这台手机上向导给出的值。
   com.gpo.yoin复制
6. 同意条款，轻点 Save。
7. 在应用页面复制 Client ID，轻点返回 Yoin。Yoin 会从剪贴板自动填好。接着登录 Spotify，允许 Yoin 访问。

需要留意

• 在 Yoin 里切换 Spotify 账号，不会切换 Spotify 应用里登录的账号。请让两边保持同一个账号。
• 登录过期时，在设置里轻点该账号上的恢复登录。如果 Yoin 连不上播放器，轻点登录 Spotify 应用，确认 Spotify 应用已经登录并允许连接。
• 如果 Spotify 提示请求过于频繁，请等一会儿再试。Yoin 会保留已经加载的内容。反复重试、退出再登录，只会让等待更久。
• 评分只留在 Yoin，不会同步到 Spotify。心形对应你的“已点赞的歌曲”。
• 在 Yoin 里播放，会接管这台设备上 Spotify 正在放的内容。
• Spotify 只有一个队列，所以用 Spotify 时没有下一首播放。

Apple Music

你需要在所在国家或地区有效的 Apple Music 订阅。歌曲通过 Apple 的 MusicKit 直接在 Yoin 里播放。

1. 在设置 › 账号里轻点添加账号，选择 Apple Music。
2. 选择开发者令牌。Yoin 的令牌服务由所有 Yoin 用户共用，你什么都不用准备。你自己的令牌服务需要 Apple 开发者计划会员资格（每年 99 美元），还要填上你的服务地址。
3. 轻点连接，用 Apple ID 登录，允许 Yoin 访问你的媒体资料库。没成功的话，再轻点一次连接。可能要试两次甚至更多。

需要留意

• 你自己导入 Apple Music 资料库、但匹配不到 Apple Music 目录的歌曲，以及在你所在地区下架的歌曲，都无法在 Yoin 里播放。它们会变暗并显示问号，轻点就能看到原因。导入的歌曲请到 Apple Music 应用里播放。
• 资料库里的专辑如果能匹配到目录里的完整专辑，Yoin 会列出它的全部曲目。已在资料库里的歌曲带 ✓，其余的轻点旁边的 ＋ 就能加入。

切换账号

你可以保存多个账号，比如家里的一台 Navidrome、一个 Spotify 账号和一个 Apple Music 账号，同一种服务也能加好几个。每个账号都有自己的资料库、首页、评分、笔记、评论和 Memories，Yoin 不会把它们混在一起。

1. 轻点首页右上角的头像，或者打开设置 › 账号。
2. 轻点想用的账号，首页和资料库就会载入它的音乐。如果切换失败，Yoin 会退回原来的账号，停在你刚才的位置。

• 账号需要重新登录时，头像上会出现红点，账号上会显示重新连接或具体原因，比如缺少 Client ID。如果只是网络断了，恢复联网后就能接着用。
• 要移除账号，在设置 › 账号里打开它的菜单，轻点移除。这只会把它从这台手机上移除：服务上的音乐不受影响，你的评分、笔记和播放记录都会保留，Google Drive 里的副本也不动。

浏览首页

首页由当前账号的音乐和你在 Yoin 里的记录组成。它有六个分区，显示哪些由你决定。

专辑封面上的小印记，标出你在那里留下了什么：实心是专辑分，描边是曲目均分，虚线是笔记。

给一张能进 Memories 的专辑打完分或写完笔记，或者在首页停留一会儿，顶部可能会浮出 Memories 气泡。轻点它就能打开那张专辑的 Memory。在首页下拉，可以打开全部 Memories。

编辑首页

每个账号都有自己的首页布局。开启云同步后，布局也会跟到你的其他设备上。下面任意一种方式都能进入编辑：

• 长按一张卡片，会把它所在的整个分区拿起来。
• 长按空白处，或者用鼠标右键单击。
• 轻点首页底部或账号卡片上的编辑首页。

然后：

• 拖移分区调整位置。拖动时，所有分区会收成带封面的横条，拖到想要的位置松手即可。
• 上下拖移“动态”或“接着听”右下角的 ⌟ 把手，改变分区的大小，一共四档。
• 轻点分区上的隐藏按钮，它会收进底部的已隐藏。轻点那里的 ＋，就能放回原来的位置。
• 改动随时保存。编辑时，底栏里有撤销（最多 20 步）和重置首页。
• 轻点完成、轻点空白处或返回，即可结束编辑。

资料库

轻点底栏里的资料库。全部会把播放列表、艺术家和专辑排在一起，艺术家是圆形，专辑和播放列表是方形。轻点顶部的胶囊，可以只看播放列表、艺术家、专辑、歌曲或收藏。再轻点一次，或轻点最左边的 ✕，就回到“全部”。

各项服务管理资料库的方式不同，Yoin 按服务本来的样子呈现。

排序与快速滚动

在“全部”“艺术家”“专辑”和“播放列表”里，轻点排序可以换一种顺序。“歌曲”和“收藏”的顺序是固定的。每个账号、每个视图的选择都各自保存在这台设备上。

• 最近：最近在 Yoin 里播放或打开过的排在前面，没碰过的按添加时间或名称排在后面。为了不让列表在你浏览时突然跳动，播放带来的顺序变化会等你下次回到资料库时才生效。
• 最近添加：按加入资料库的时间排列。艺术家没有这个选项，Spotify 的播放列表也没有，因为它们不带这个时间。
• 字母顺序：按你所用语言的顺序排列。用 Subsonic 时，开头的冠词（比如“The”）会被忽略。
• 创建者：专辑按艺术家排，播放列表按创建者排。

“播放列表”里既有你自己建的、也有你关注的列表时，顶部会出现你创建的胶囊，轻点它就只看你自己的。用 Apple Music 时，Yoin 以 Apple Music 标为可编辑的播放列表为准。

在“全部”“艺术家”和“专辑”里滚动时，右侧会出现一个把手。按住拖移，可以按字母（A–Z、假名、韩文、#）快速跳转；按“最近”排序时则按日期跳转。停下片刻后它会自动收起，不挡封面。

搜索

轻点资料库顶部的搜索栏，搜索你的资料库。想直接搜 Spotify 或 Apple Music 的目录，长按底栏里的资料库。用 Subsonic 时，两种方式搜的都是你的服务器。

• 用 Spotify 和 Apple Music 时，可以在搜索栏下方切换：搜你的资料库，还是搜整个目录。Spotify 的资料库搜索在 Yoin 存在手机上的那份资料库副本里进行；Subsonic 搜索整台服务器。
• 用全部、艺术家、专辑、歌曲或播放列表筛选结果。Spotify 和 Apple Music 可以搜到播放列表。
• 轻点歌曲直接播放，轻点专辑、艺术家或播放列表进入详情页。在 Apple Music 的目录结果里，轻点 ＋ 就能把歌曲加入资料库。

专辑、艺术家和播放列表

打开一张专辑，能看到封面、专辑信息、播放和随机播放按钮、上次在 Yoin 里播放的时间，以及右上角的唱片刻纹徽记。

• 往下滚动曲目时，封面会收成顶部的一条封面色带，右侧停着一枚小封面。轻点小封面，就能滚回顶部。窗口较宽时，专辑信息会一直留在左侧一栏。
• 正在播放的曲目会显示跳动的均衡器，写过笔记的曲目带笔记标记。每一行都有心形（Subsonic 和 Spotify）或 ＋（Apple Music），以及更多操作 ⋯。
• 向左轻扫，翻到第二页“剪贴簿”。无论在哪一页，返回都会直接离开这张专辑。

艺术家页有圆形头像、你听得最多的歌曲和作品列表。用 Subsonic 可以给艺术家加星标，用 Spotify 可以关注艺术家。

在播放列表页可以播放或随机播放。如果你能编辑这个播放列表（Subsonic 或 Spotify），还可以在这里改名、改简介、移除歌曲或删除列表。Apple Music 的播放列表只能浏览。

轻点页面或曲目上的 ⋯，可以下一首播放（Subsonic 和 Apple Music）、加入队列、添加到播放列表、前往艺术家、在服务自己的应用中打开，或者分享。在大屏上，底栏里已有的操作不会在菜单里重复出现。

在平板或展开的折叠屏上，专辑、艺术家和播放列表会在首页或资料库旁另开一栏，一条底栏横跨两栏。

播放正在播放

轻点底栏里的歌曲，打开正在播放页。向下轻扫、用返回手势，或轻点顶部的箭头，都能把它关掉。

歌曲还在加载，或 Yoin 还在连接 Spotify 应用时，播放按钮会显示加载状态，真正出声后才切换为播放。

在手机上，轻点底栏会直接打开全屏的正在播放页。在平板或折叠屏上，它会先在右侧以面板打开，轻点面板顶部角落的按钮可以全屏。返回时按全屏、面板、底栏的顺序一层层退回。手机横过来拿时，底栏会挪到侧边。

用 Apple Music 播放超过 300 首歌的列表时，Yoin 会先去掉无法播放的曲目，再以你选的那首为中心排进最多 100 首，其中大约 20 首在它之前。

队列

轻点正在播放页的队列。这里按实际播放顺序列出接下来要放的歌，开了随机播放也一样；播完的歌不会留在列表里。队列分三部分：

• 正在播放：当前这首。
• 队列中接下来：你用“下一首播放”或“加入队列”加进来的歌。
• 接下来：你正在播放的专辑、播放列表或艺术家里剩下的曲目。

下一首播放把歌曲排在当前这首的紧后面（Subsonic 和 Apple Music）。加入队列把它排在“队列中接下来”的末尾，在专辑或播放列表剩余曲目之前。

• Subsonic：轻点歌曲直接跳过去播放。关闭随机播放时，按住把手拖移，可以在同一部分内调整顺序。向左轻扫移除一首，轻点清除移除你加入的全部歌曲。
• Apple Music：可以轻点跳播，也可以移除歌曲。MusicKit 不支持调整顺序。
• Spotify：队列只能查看，显示正在播放什么、从哪里播放。
• 改动队列，不会修改你保存在服务上的播放列表。

心形与播放列表

心形的作用取决于服务。它和评分互不影响：打高分不会点亮心形，点亮心形也不会自动打分。

• Subsonic：轻点歌曲、专辑或艺术家上的心形，在服务器上加星标；再轻点一次取消星标。
• Spotify：歌曲上的心形会把它加入或移出“已点赞的歌曲”。在专辑的 ⋯ 菜单里轻点保存到资料库保存专辑，在艺术家页轻点关注关注艺术家。
• 如果网络中断或服务拒绝，心形会恢复原状，Yoin 也会提示你。

在 Yoin 里，Apple Music 没有心形，改用 ＋ 把歌曲加入资料库：目录搜索结果、专辑曲目和正在播放页上都有。Apple Music 在后台处理入库，所以按钮会等 Yoin 在你的资料库里找到这首歌，才显示 ✓。随后资料库会在后台刷新，不会把你从当前位置带走。在 Yoin 里无法从 Apple Music 资料库移除歌曲。

用 Subsonic 和 Spotify 时，你可以管理自己有权编辑的播放列表。Apple Music 的播放列表只能浏览。

• 新建：在资料库的“播放列表”里轻点新建播放列表，填上名称和简介。
• 添加歌曲：轻点歌曲的 ⋯，选添加到播放列表，再选目标列表。
• 在可编辑的播放列表里，可以改名、改简介或移除歌曲。同一首歌出现两次时，只会移除你选的那一行。
• 在 Subsonic 里删除播放列表，会从服务器上删掉它；在 Spotify 里则是按 Spotify 的规则取消关注这个列表。

歌词与笔记歌词

轻点正在播放页的歌词。Yoin 按以下顺序决定显示哪份歌词：

1. 你手动选定或自己编辑过的歌词，永远排第一。
2. 用 Subsonic 时，用服务器上的歌词。除非你自己搜索，Yoin 不会去别处找。
3. Spotify 和 Apple Music 不提供歌词，Yoin 会先查手机上存过的，再依次去 QQ 音乐、网易云音乐和 LRCLIB 找。
4. 华为音乐只在你自己搜索时使用。

• 同步歌词逐行高亮，当前行保持居中。轻点任意一行，就跳到那一句。
• 播放同步歌词时，约 3 秒没有触碰，控件会自动收起。轻点、滚动或暂停，就会重新出现。
• 歌曲快结束时，如果已经知道下一首（主要是 Subsonic），底部会提前显示下一首。

歌词不对，比如匹配到了现场版，就在歌词工具里搜索。结果来自 QQ 音乐、网易云音乐、华为音乐和 LRCLIB。核对歌名、艺术家和时长后，轻点一个即可换上。想自己写或粘贴 LRC 文本，打开歌词编辑器。

Yoin 自动找到的歌词会保存 30 天。你从搜索结果里选的歌词不会过期，你自己输入或粘贴的歌词也不会为了腾空间被清掉。

翻译与分享

在设置 › AI 功能里，把回答语言设成你想要的语言，它和应用界面的语言互不影响。然后在歌词里轻点翻译按钮。

• 如果某个歌词源带有这种语言的译文，Yoin 会直接用，或者提示你换成这个来源的整套原文和译文。它不会把一个来源的原文和另一个来源的译文按行硬拼。
• 没有现成译文、你又保存了 Gemini 密钥时，Gemini 会翻译整首歌，译文存在你的手机上。
• 开关翻译时，当前这一行会停在原位。

复制或分享歌词：

1. 轻点 ✓ 选择歌词行。选择期间，歌词不再跟着播放滚动。
2. 轻点想要的行，最多 15 行，可以不连续。
3. 复制为文本：按歌曲原来的顺序排好，不连续的段落之间空一行，开了翻译会附上译文，末尾带上歌名和艺术家。
4. 或者分享为图片。选择卡片（宽 1440 px，高度随行数变化）或 Story（1080 × 1920，内容多时等比缩小），再从封面取色的四套配色里挑一套：柔和、深色、鲜艳或薄雾。保存会存进 Pictures/Yoin（Android 10 及以上）；分享直接发出去。

歌词与笔记评分与评论

评分和评论保存在 Yoin 里，所有服务都能用。用 Subsonic 时，歌曲评分还会同步到服务器。

• 在正在播放页拖移评分条，给歌曲打 0.0 到 10.0 分，每格 0.1。评分条竖着贴在封面旁边，横屏等较挤的布局里则横着放。拖回 0 即取消评分。
• 用 Subsonic 时，Yoin 自己保留小数，给服务器的是 0 到 5 星：分数除以 2 再四舍五入。
• 评分和心形互不影响。

要给专辑打分、写评论，轻点专辑右上角的唱片刻纹徽记，或者它的 Memory 里的评论。横向拖移评分条给整张专辑打分，徽记会跟着变化，松手就保存；上下滚动面板不会误改分数。在下方的输入框写评论，输入框会随字数长高，收起面板时自动保存。

徽记显示一张专辑的状态：

• 中心标签是实心的：你给专辑打过分。专辑分永远优先于曲目均分显示。
• 描边标签：你还没给专辑打分，但给其中一些曲目打过分，显示的是它们的平均分。
• 虚线：还什么都没评。
• 每一圈对应一首曲目，最外圈是第一首。实线圈是评过分的曲目，点线圈是还没评的。

笔记

每条笔记都钉在歌曲的某个时刻，保存在 Yoin 里。

1. 在正在播放页轻点笔记。
2. 轻点输入框开始打字。你开始输入的那一刻，Yoin 就把当前时间记作这条笔记的时刻。
3. 如果歌已经往前播了，想把时刻改成现在，轻点输入框旁边的对齐按钮。
4. 轻点保存，笔记就加进列表，键盘保持展开，方便接着写下一条。输入框是空的时候，收起键盘它就会缩回去。

• 笔记按歌曲时间顺序排列，播到哪条，哪条就亮起来。它们也会在进度条上显示为标记。早年没有时间的笔记显示为空心小圆点。
• 在正在播放页轻点笔记，就跳到它的时刻。在剪贴簿或 Memory 里轻点，Yoin 会先开始播放这首歌，就绪后再跳过去；超过约 4 秒还没就绪，就从头播放。
• 长按笔记，可以把它的时刻改成现在，或者删除。删除后约 5 秒内，轻点撤销就能恢复。
• 笔记保存在你的手机上。开启云同步后，新增和删除都会同步到你的其他设备。笔记不会发到你的音乐服务，也不会发到 NeoDB。

剪贴簿

在专辑页向左轻扫，翻到第二页。剪贴簿把你在这张专辑上留下的一切收在一起，像纸片一样摆在点阵纸上：

• 顶部是你的专辑评论，挨着封面和徽记。还没写的话，轻点写评论。如果你有旧版的专辑笔记，它会以折角便签的样子出现在下面，可以阅读。
• 你的笔记，按曲目排列。每首曲目先显示 3 条，轻点下方的条数可以看其余的。轻点一条笔记，就从那个时刻开始播放。
• 只打了分的曲目，是一张张数字小票。如果有曲目打到 9.0 分或以上，全专辑最高分的那首会用一张更大的实心票根。
• 你向 Gemini 查过的歌曲信息和提问，写在标着 Q 的索引卡上，按曲目归档，和你自己写的内容分开。
• 底部是一张收据，记着你在 Yoin 里播放这张专辑的情况。

一张你还什么都没留下的专辑，这一页会列出它的曲目，轻点就能播放。

Memories

Memories 收着你认真听过的专辑，一张专辑一张卡片，跟随当前账号。在首页下拉就能打开，也可以轻点首页顶部的气泡或 Memories 桌面小组件。

一张专辑至少有 4 首已知曲目，并且你做到以下任意一项，它就会成为 Memory：

• 给其中至少 60% 的曲目打过分；
• 写过专辑评论；
• 在这张专辑或其中的曲目下写过至少 2 条笔记。

只是反复播放、只问过 Gemini，或者只打了一个专辑总分，都不够。

在手机上，Memories 有两种状态；在够宽的平板上，两者左右并排。

• 卡片：左右轻扫切换专辑。卡片上有封面、唱片刻纹徽记（倾斜手机时会映出光泽）、标题，以及从你的评论或笔记里摘出的一整句话。
• 日记：轻点卡片下方的日记。你的评论排在最前面；还没写的话，会用一句关于你收听情况的简短文字代替，并留出空白让你动笔。下面列出你打过分或写过笔记的曲目，轻点前往专辑可以看完整曲目表；最底部是你在 Yoin 里播放这张专辑的次数，以及距第一次播放过了多久。

在卡片上往下拉只会回弹，不会打开日记。要离开日记，在顶部继续下拉、拖移日记顶栏、轻点小封面，或者返回。要离开 Memories，在卡片上向上推、轻点顶部的“首页”，或者等日记滚到底停稳后再向上推。

保存了 Gemini 密钥的话，每个 Memory 的标题由 AI 来写。轻点标题可以改成你自己的，也可以恢复 Yoin 起的那个。

可选AI 功能

在设置 › AI 功能里粘贴你自己的 Gemini API 密钥，轻点保存密钥。回答用什么语言，在回答语言里选。请求从手机直接发往 Google 的 Gemini API，费用记在你的密钥上。不填密钥，Yoin 的其他功能照常使用。

• 歌曲信息：在正在播放页的关于里，Gemini 会借助 Google 搜索查找这首歌，填上创作时间、录制地点、作词、作曲、制作人和背景介绍。查不到的就空着。
• 问 Gemini：在歌曲信息下方提问，比如编曲细节、采样来源或某句歌词。回答会连同一个简短标题保存在这首歌下，并归档到专辑的剪贴簿里。
• 歌词翻译：歌词没有自带你所选语言的译文时使用。
• Memories：给还没写评论的专辑配一句关于你收听情况的简短文字，并给每个 Memory 起标题。

Gemini 收到什么，取决于功能：

保存密钥后，Memories 的文字和标题会在 Memories 加载时自动生成，不用另外轻点。密钥只存在你的手机上，不会同步到 Google Drive，但 Android 备份可能包含它。AI 的回答和译文可能有错。

NeoDB

在设置 › NeoDB 里填上你的实例，比如 neodb.social，然后登录，或者改用访问令牌。

之后，只要专辑能在 NeoDB 上匹配到条目，你保存专辑评分和评论时，它们就会发到 NeoDB。收起专辑的评分面板，或在 Memories 里保存评论，就算保存。评分面板和日记底部会显示同步状态。

• NeoDB 上的分数会四舍五入成 0 到 10 的整数。
• 360 字以内的评论作为短评发到 NeoDB，更长的作为长评。在 Yoin 里清空评论，NeoDB 上的文字也会一并清掉。
• 长评会公开发布。短评沿用 NeoDB 上那条记录原有的可见范围，新记录则是公开的。Yoin 没有可见范围设置，所以别把 NeoDB 当成私密记录。
• 没有未上传的改动时，Yoin 也会从 NeoDB 读回你的评分和评论：有长评读长评，没有就读短评。
• 歌曲笔记永远不会发到 NeoDB。
• Yoin 里的评分按账号分开，但如果你的两个账号连着同一个 NeoDB 账号，又给同一张专辑打了分，NeoDB 上只会有一条记录。

云同步

默认关闭，要你自己在设置 › 云同步里打开。授权 Google Drive 后，Yoin 会把你的记录存在你自己 Google Drive 里的一个隐藏 Yoin 文件夹中，占用你的存储空间。Yoin 只能看到这个文件夹，看不到你的其他文件，也不需要 Yoin 账号。云同步需要 Google Play 服务，部分测试版可能没有这项功能。

打开或离开 Yoin 时、有改动之后，以及你手动要求时，都会同步。

这些文件不是端到端加密的，所以密码、登录信息和密钥从不放进去。

换了新手机、登录同一个 Google Drive 时，Subsonic 账号按服务器地址和用户名匹配，Spotify 账号按 Spotify 用户 ID 匹配。Apple Music 没有跨设备不变的账号 ID，需要你自己关联一次：在云同步里，轻点 Apple Music 记录上的关联。

• 评分和首页布局以最后一次修改为准。如果两台设备在离线时改了同一张专辑的评论，Yoin 会把两段都留下，标上设备和日期，由你来整理。
• 在此设备上关闭：停止这台手机的同步。数据仍留在这台手机和 Drive 里，其他设备继续同步。
• 删除云端数据：从你的 Drive 删除 Yoin 的数据，并关闭其他设备上的同步。这台手机上的数据会保留。

系统桌面小组件

在主屏幕空白处长按，轻点微件，找到 Yoin。

• 播放显示你最近播放或打开过的专辑、播放列表和艺术家。轻点封面或标题进入详情页，轻点播放按钮直接开始播放；播放器还没就绪时，Yoin 会改为打开详情页。
• Memories 显示当前账号 Memories 里的一张专辑，带徽记、分数、标题和上次收听的时间。轻点就能打开那个 Memory。

调整小组件大小时，排版会跟着新尺寸变化。

外观与无障碍

• 深浅色跟随系统。在 Android 12 及以上，颜色取自你的壁纸；播放音乐时，会过渡到取自封面的颜色。
• 滚动时内容怎样移入顶栏下方，在设置 › 动效 › 滚动边缘里设置：潮线（两道柔和的波浪，默认）、网点（封面散成细密的网点）或曲奇浪口（封面离开时，上缘化作曲奇花边）。
• 开启“移除动画”或省电模式时，Yoin 会停掉首页编辑时的摆动和 Memories 的倾斜光泽，把飞入、变形换成简单的淡入淡出，功能一样不少。
• TalkBack 能读出每个图标按钮、徽记和播放状态。编辑首页时，可以用无障碍操作菜单或方向键上移、下移、隐藏分区，或调整它的行数。
• 调大系统字体时，文字会自动换行，保证主要的播放按钮留在屏幕上。

缓存、投播与音质

• 缓存：用 Subsonic 时，Yoin 会缓存你播放过的音频，最多约 500 MiB，最久没播的先清掉。设置 › 存储里可以看到占用多少，也能清除。缓存不等于离线下载；要在 Spotify 或 Apple Music 上离线听，请在它们自己的应用里下载。
• 投播：用 Subsonic 时，轻点正在播放页的设备，就能投播到同一网络里的 Chromecast，前提是它能访问你的服务器。停止投播后，会回到手机上播放。用 Spotify 时，播放设备由 Spotify 应用里的 Spotify Connect 决定。
• 音质：Subsonic 取决于你的文件和服务器设置，Spotify 取决于你在 Spotify 应用里设的音质，Apple Music 由 MusicKit 传送音频。Yoin 不宣称无损或空间音频。
• 进度条上的波浪和切歌时的光效，是跟随播放状态的动画，不是对音频的实时读数。

参考各服务支持情况

各项服务在 Yoin 里能做什么。评分、笔记、评论、剪贴簿、Memories、首页布局、AI 功能和 NeoDB 在三种服务上都能用，由 Yoin 保存。暂不支持手机上的本地音乐文件。

帮助故障排查

• Subsonic 连不上，或者没法编辑播放列表。检查地址是否带有 http:// 或 https:// 和正确的端口，并在同一网络下用手机浏览器试着打开。如果能播放但看不到编辑按钮，说明服务器把这个播放列表标为只读，或者它不属于你。
• Spotify 能看到资料库，但点歌没声音。确认手机装了 Spotify 应用、登录的是同一个账号，并且这个账号有 Premium。如果 Yoin 提示登录或配置有问题，到 Spotify 开发者后台核对重定向 URI、包名和 SHA1 指纹，是否和这台手机上 Yoin 向导显示的完全一致。
• Apple Music 的歌曲变暗并显示问号，或者轻点 ＋ 后没有马上变成 ✓。变暗的歌曲是你导入的、匹配不到目录，或在你所在地区不可用，轻点就能看到是哪一种。轻点 ＋ 后，要等 Apple Music 完成入库、Yoin 在资料库里找到这首歌，才会显示 ✓。
• 一张常听的专辑没出现在 Memories 里。它需要至少 4 首已知曲目，并且你给其中 60% 打过分、写过专辑评论，或写过 2 条笔记。另外，确认你没切到别的账号。
• 换了新手机，看不到 Apple Music 的记录。在设置 › 云同步里，把 Drive 里的 Apple Music 记录关联到这台手机上的 Apple Music 账号。
• Android 提示 Yoin 与 16 KB 不兼容。部分较新的 Android 版本会显示这个提示。它来自 Apple 的 MusicKit 库，不是 Yoin 自己的代码造成的。

已知问题

• Apple Music：先「下一首播放」再「加入队列」。已经有一首设为下一首播放时，再加入队列的歌会排到整个队列最后，而不是排在它后面。如果这首歌本来就在正在播放的专辑里，队列里可能会出现两次。
• Apple Music：随机播放会挪动「下一首播放」。打开或关闭随机播放后，之前设为下一首播放的歌可能不再是下一首。

反馈

请通过反馈表单发送反馈。在 Yoin 里轻点发送反馈：账号卡片上有（轻点首页的头像打开），设置 › 关于里也有。

也可以写信到 lastnatsu51@gmail.com。最好写上：

• 应用版本（在设置 › 关于里查看），以及安装渠道。
• 设备型号和 Android 版本；用折叠屏的话，说明当时是折叠还是展开。
• 用的是哪项服务：Subsonic、Spotify 还是 Apple Music。
• 当时的窗口形态：手机竖屏、手机横屏，还是平板分栏。
• 你轻点了哪里、本来期待什么、实际发生了什么。方便的话，附上录屏或截图。

帮助隐私

Yoin 没有 Yoin 账号，没有广告，也没有统计分析。这里是简要版；完整的隐私政策（英文）写有全部细节。

在你的手机上

你的账号（服务器地址和用户名）、密码和登录令牌、评分、笔记、评论、播放记录、缓存的歌词，以及 Gemini 密钥，都存放在 Yoin 的私有存储空间里。Android 备份可能包含主数据库，比如评分、笔记和 Gemini 密钥。密码和登录信息经过加密，不会进入备份。

哪些数据会离开手机，去往哪里

麦克风

Yoin 不会录音。

删除你的数据

在设置里移除账号、清除 Yoin 的存储空间，或者卸载 Yoin。你的服务器、Spotify、Apple Music、NeoDB 或 Google Drive 上的数据，请到各自那里管理。