IwaraFlow

Android 原生的 Iwara 竖屏短视频流播放器，提供类似短视频 App 的连续浏览体验。

播放器 AndroidX Media3 / ExoPlayer，默认最高可用画质，可手动切换清晰度 单击播放 / 暂停 暂停时在视频标签下方显示可拖动的进度条，同时隐藏信息栏和操作栏；播放时恢复 暂停时进度条上方、左下角显示控制行：后退 N 秒 / 播放三角 / 前进 N 秒。N 在设置中选择（5 / 10 / 15 / 30 / 60，默认 15），播放三角可在设置里关闭 横屏视频画面略高于屏幕中央（抬起卡片高度的 24%），竖屏视频铺满 按住画面约 0.45 秒临时 2× 加速，松手恢复，加速时显示 2× 加速中 点赞 / 收藏 / 双击点赞的动画播在点击的位置：按钮上或手指落点 画中画（PiP），可设置切到后台自动进入 分享：应用内分享面板列出能接收链接的应用，点选后直接拉起该应用的分享入口（QQ 等应用以自己的小窗卡片盖在视频上，视频继续播放）；另有复制链接和系统选择器 播放地址过期或出错时自动重新解析并从原位置继续，最多重试 2 次 播放卡死看门狗：时间轴长时间不前进时自动重建播放源 全 App 单一播放所有权：进入其它视频页面时立即停止上一页面的播放器 评论 右侧操作栏的评论按钮打开底部半屏面板，内容为 Iwara 官方评论；主页、作者页、搜索页的播放流都有 支持回复：发送到 Iwara 官网，与网页端回复等价；「共 N 条回复」原地展开 / 收起 面板顶边对齐画面底边：横屏视频面板接在画面下方，竖屏视频画面按比例缩到顶栏与面板之间 面板打开时播放不受影响；点击画面、翻页、返回键、进入小窗均关闭面板 写评论时输入层贴在键盘上方、盖在面板之上，页面和面板不收缩；点空白处收起键盘，未发送的文字保留为草稿 未登录时点输入框会先弹出登录框 点评论者的头像或名字进入其主页；没有作品的用户只显示资料，作品列表标明“没有作品” 作者主页 / 关注 / 好友 点击作者名进入作者主页，分页展示该作者作品并显示真实缩略图 简介默认显示三行，点击展开全文，滑动作品列表时收起 不可播放的作品保留在列表中，并在缩略图上标出原因（仅限好友 / 无权限 / 处理中 / 资源失效） 点击可播放作品后进入仅包含该作者作品的竖滑播放流，支持首尾循环 返回顺序：作者播放流 → 作者作品列表 → 进入作者页的页面；系统返回键、全面屏手势和页面按钮共用同一逻辑 关注 / 取消关注，好友申请 / 取消申请 / 删除好友，状态与 Iwara 官方同步 主菜单「已关注用户」按服务端总数翻页读取，关注数超过 50 也会全部列出 作者主页可分享作者名字、简介和主页链接 Iwara 账号 登录：/user/login → /user/token；Token 使用 AndroidX Security 加密存储，密码不落盘 点赞：POST / DELETE /video/{id}/like 点赞列表：/favorites/videos，后台完整翻页同步并计入已看 关注、好友关系同步 收藏与浏览历史 爱心 = Iwara 官方点赞，同步到服务端；五角星 = 本机收藏，存在本地 SQLite。两者互不影响 浏览历史记录最后播放位置、时长和是否基本看完 独立 seen_videos 表永久记录推荐系统使用的“已看视频 ID”，数据库升级时自动迁移 我的收藏、浏览历史、已下载共用同一套卡片列表布局 搜索与下载 独立的搜索结果页，三个标签页： 视频名：/search?type=videos&query=... 标签：/videos?tags=...；空格、逗号、顿号分隔的多个词表示同时带这些标签，无结果时按下划线、连写当作单个标签重试 作者名：/search?type=users&query=...，显示头像并可进入作者主页 视频结果保留不可播放作品并显示原因，可播放的在结果内竖滑播放 下载走 Android DownloadManager，下载前可选清晰度 已下载页面：App 记录下载过什么，页面向系统下载器查询实际状态 已完成的直接播放本地文件；仍在下载 / 失败的在卡片上标出；系统里已查不到的退回在线播放 同一视频的不同清晰度各算一条，重新下载同一清晰度覆盖旧记录 打开页面时自动补录系统下载器中本应用发起过、但本地表没有的下载（按文件名 <标题>_<视频 id>_<清晰度>.mp4 从右往左解析）

菜单与设置 主菜单：登录 / 退出、浏览历史、我的收藏、已下载、已关注用户、设置、检查更新、重新加载当前流。

设置页：

分组 内容 推荐 刷新推荐时排除已看视频；老片穿插间隔（关闭 / 8 / 12 / 16 / 24） 播放 播放完毕自动进入下一条；切到后台自动进入画中画；暂停时显示播放三角；前进 / 后退秒数 默认清晰度 对之后播放的视频生效；当前视频用右侧画质按钮切换 网络 手动代理（HTTP / SOCKS，主机 + 端口），进程级生效，播放器、图片和接口请求全部经过 维护 同步点赞记录；诊断信息 维护项是动作而非开关，点击立即执行，不需要保存，也不关闭设置页 保存设置只在推荐候选真正受影响（排除已看、老片穿插改动且当前在推荐流）或代理改动时重新加载列表，其余设置直接应用到当前卡片，不打断播放 诊断信息写成 txt 文件（保留最近 5 份），可复制或直接以文件形式分享到其它应用；只记录异常、退出原因和加载线索，不记录账号或视频列表，不自动上传