使用帮助
从下载到「把平板变成 Mac 的第二块屏幕」，一步一步走完。第一次安装只需走一遍 Step 1–5，之后日常看 Step 6。
VivLink 是什么
VivLink 把你的平板变成 Mac 的第二块屏幕。Mac 端是一个常驻菜单栏的小应用（VivLink Companion.app），它建立一块虚拟显示并实时推流；鸿蒙端 App 在同一局域网内自动发现并上屏。
你可以在平板上触控、滚动、用键鼠双向操作 Mac —— 像操作本机一样自然。适合轻办公扩展桌面、对照阅读、外接演示、跨设备协作。
画面只在局域网内传输，不经过云端。
使用前准备
| 端 | 需要什么 | 备注 |
|---|---|---|
| Mac 端 | Apple 芯片（M 系列）；macOS 13 或更新 | 无 Dock 图标，启动后常驻菜单栏。最低系统版本以官网下载说明为准 |
| 鸿蒙端 | HarmonyOS NEXT 6.1.0（API 23）及以上的平板 / 折叠屏 / 手机 | 目标形态是平板 |
| 网络 | 平板与 Mac 连同一个局域网（同一路由器，优先 5GHz） | 两端同一网段才能自动发现；防火墙或访客网络可能扫不到 |
当前能力以「720p / 1080p 两档分辨率、2–12 Mbps 五档码率（运行期可调）、触控与键鼠回传、窗口模式（画中画）、局域网直连」为基准。音频、多平板、笔压感仍在路线中，不在本说明承诺。
上手总览
- 下载 Mac 端
- 安装并首次打开
- 扫码激活
- 授权两项系统权限
- 启动虚拟屏 + 平板连接即用
前五步只走一次。之后日常真正会反复看的是 Step 6 —— 界面怎么用、卡了怎么调。
Step 1 · 下载 Mac 端
- 在电脑上打开本官网的「下载」区，点「下载 Mac 版」。
- 得到安装包 VivLink-Companion-<版本>.zip（旁边提供 .shasum 校验值，可选核对）。
- 下载完成后解压，得到 VivLink Companion.app 与一份「使用说明-<版本>.txt」。
Step 2 · 安装并首次打开
- 建议把 VivLink Companion.app 拖进「应用程序」文件夹（也可以就地双击运行）。
- 首次双击时，macOS 可能弹出 Gatekeeper 提示「无法打开，因为无法验证开发者」。按下面任一方法放行。
方法 A（推荐给普通用户）
在访达中右键 VivLink Companion.app → 选「打开」→ 在弹窗里再点一次「打开」。
方法 B（偏好命令行的用户）
打开「终端」，执行下面这行，然后双击打开：
xattr -dr com.apple.quarantine "/Applications/VivLink Companion.app"macOS 15（Sequoia）及以后：右键旁路已被移除
弹窗里通常只有「完成 / 移到废纸篓」，没有「打开」按钮。此时先双击一次让它被拦下 → 打开「系统设置 → 隐私与安全性」→ 往下滚到「安全性」区 → 找到那条拦截记录，点「仍要打开」→ 输入开机密码确认。或者直接用上面的方法 B，一条就够。
- 打开后不会出现 Dock 图标。请在屏幕右上角菜单栏找 VivLink 图标（一条辐射波纹；未推流时灰、推流中变绿）—— 它表示 VivLink Mac端 已常驻运行。
Step 3 · 扫码激活
首次打开时，Mac 端会显示一张二维码。完成激活有两种方式，任选其一 —— 这一步只需做一次。
- 在鸿蒙端打开 VivLink App，进首页，点「激活」按钮。
- 方法一 · 扫码：对着 Mac 屏幕上的二维码扫一下。
- 方法二 · 备援码：在「附近的待激活设备」里选中这台 Mac，输入 Mac 上显示的 8 位备援码。
- 提示激活成功后，回到 Mac —— 面板自动关闭，菜单栏图标亮起，各项菜单可用。
备援码每次都会变
二维码与 8 位备援码是一次性的，且会随二维码刷新而更新。若提示「备援码不对」，以 Mac 屏幕上此刻显示的为准。
平板上的「已激活」标记，不等于 Mac 已激活
那个标记只记录「这台平板走过一次激活流程」；激活状态保存在 Mac 上，平板无从得知。若 Mac 重装系统、换新机或清空钥匙串，标记不会自动消失 —— 此时请到激活页重新走一次流程。
Step 4 · 授权两项系统权限
VivLink Mac端 只申请屏幕录制和辅助功能两项系统权限，都是扩展屏的核心能力 —— 不读取相册、麦克风或摄像头。
- 激活完成后会自动弹出「首次设置」窗口，列出两项待授权。若没自动弹，点菜单栏图标 →「权限与首次设置」随时重开。
- 逐项授权：每项右侧点「打开系统设置…」会直接跳到对应的隐私面板。
| 权限 | 为什么要给 |
|---|---|
| 屏幕录制 | 抓取 Mac 屏幕推流给平板 —— 推流必需 |
| 辅助功能 | 把平板的点按 / 键盘回传注入 Mac —— 回传必需 |
- 在系统设置里找到 VivLink Companion，把开关打开，然后回到首次设置窗口。
- 两项都显示绿色「已授权」后，点「开始使用 →」。若某行仍显示未授权，点底部主按钮按提示重启 App 一次使授权生效。
小提示：授权是记在「打开 App 的那个进程」上的。请用双击或访达打开的方式启动 VivLink Mac端；从终端命令拉起的，屏幕录制会记到终端头上，反复开开关都没用 —— 退掉后用双击重开即可。
Step 5 · 启动虚拟屏 + 平板连接
Mac 侧
- 授权完成后点「开始使用」即会自动建立虚拟屏开始推流（菜单栏图标变绿）。此后也可随时点菜单栏图标 →「启动虚拟屏」手动启停。
- 点菜单栏图标打开面板，会看到一行地址「平板连接到此地址」—— 旁边按钮可复制，平板手动连接时会用到。想调整第二屏分辨率，点「平板显示设置」去系统设置 → 显示器里改。
用 4K 显示器的用户请注意
连接期间 4K 主屏会降为 1080，属 macOS 虚拟屏行为，摘下即恢复。这是系统接入虚拟屏时的管理行为，不是本软件的设置错误。
鸿蒙侧
- 打开 VivLink App 首页。App 会自动扫描同一局域网内的 Mac（一般几秒内出现）。
- 在「目标设备」卡里选中你的 Mac（显示电脑名与 IP，在线为绿点）→ 点下方主按钮「连接 →」。
- 没扫到？点首页下方的「未发现设备？手动添加」，输入或粘贴上一步复制的地址 → 连接。
- 连接成功后，Mac 桌面即出现在平板画面中，会话界面随之出现。顶栏显示连接信息与上屏帧率，最右端的电源图标就是「断开」—— 点它并在确认框里确认，即停会话回首页。
Step 6 · 会话界面与日常使用
三块区域：画面归 Mac，操作归留边区
会话界面只有三层：顶部状态栏、中间的 16:9 画面盒、底部控制栏。画面盒上下的黑边叫「留边区」。
| 区域 | 点按行为 |
|---|---|
| 画面盒内 | 全部回传给 Mac —— 触摸、滚动、鼠标点击直接作用到 Mac 上。App 不在这里响应任何手势。 |
| 留边区 · 单击 | 唤出 / 收起顶栏与底栏。 |
| 留边区 · 双击 | 切换全屏与窗口。 |
为什么画面区不认手势：以前「点画面唤出控制栏」会和 Mac 的操作抢手势 —— 你想拖个窗口，App 却把控制栏弹了出来。现在画面区完全交给 Mac，App 的操作一律走留边区。所以在画面上到处点却没弹出控制栏，是正常的，不是坏了。
顶栏与底栏在「无操作 5 秒」后自动隐藏，保持画面干净。想看状态、想调档，单击一下留边区。
底栏六个格子（从左到右）
| 格 | 说明 |
|---|---|
| ① 回传 | 点一下直接切换（绿点 = 开 / 灰点 = 关），不弹面板。需要精确用鼠标操控 Mac 时保持开；觉得触摸不够跟手、只想看画面时可关掉。 |
| ② 分辨率 | 720p / 1080p。点开向上弹出档位。网络偏弱或画面卡顿时降到 720p 通常明显变稳。会记住，下次连接沿用。 |
| ③ 码率 | 2 / 4 / 6 / 8 / 12 Mbps，默认 8 Mbps。切换码率不会重连，画面不中断也不闪，适合边看边调。同样会记住。 |
| ④ 状态 | 打开状态卡（详见下节）—— 显示当前鸿蒙端与 Mac 端的连接信息。 |
| ⑤ 窗口 | 进入系统画中画小窗，见下节。 |
| ⑥ 全屏 | 图标随状态变。等同留边区双击。 |
分辨率与码率互不联动：改分辨率会重建一次会话（画面会闪一下，属正常），改码率不会。
④状态 · 只读状态区
点④设置格弹出一张状态卡，分三组：本机（帧率、传输计数、媒体字节）、Mac 端（实测码率 / 帧率、丢包、心跳、两项授权状态）、当前档位（分辨率、码率）。
其中「屏幕录制」「辅助功能」两行的值是已授权 / 未授权，并按状态着色 —— 未授权时是红的，这是全卡最该看的地方。
回传没反应？先看这两行
辅助功能没授权时，Mac 会静默丢弃你回传的键鼠事件 —— 菜单栏不会有提示，很容易误判成「协议坏了」。看到红色的未授权，就去 Mac 系统设置里勾上（见 Step 4）。
没数据的字段显示「不可用」，不会补 0 —— 看到「不可用」表示这项还没有数据，不代表它是 0。点卡片外的空白处关闭。
⑤窗口 · 让画面挂在桌面上（画中画）
点⑤窗口格 → 画面交给系统画中画小窗常驻桌面最上层，同时 VivLink 退到后台、设备回到桌面。想一边看着 Mac 画面一边做别的事时用这个。
- 会话不会断。Mac 继续推流、平板照常收；关掉小窗回到 App，画面接着走，不用重连。
- 小窗里不能操作 Mac。小窗期间输入全部停用。它的定位就是「挂着看」，要交互请关掉小窗回到 App。（这不是没做，是系统限制 —— 小窗画面区的触摸事件根本到不了 App。）
- 小窗底部那枚「播放 / 暂停」按钮去不掉（当前 HarmonyOS API 不支持自定义小窗控件）。点它不会真的暂停会话，无视即可。
- 进小窗的前提是会话已连上并出画：还在连接中时点它，会记下你的意图，等画面一就绪自动进小窗（30 秒内有效）。
Step 7 · 后台与自动收尾
- 正常将 app 切到后台运行会停流。扩展屏 = App 自己持续收流渲染，切回桌面或跳到别的应用时画面会停。唯一的例外是窗口模式（见 Step 6.4）—— 走⑤窗口格进画中画，App 退后台而会话不死。
- 断开：点顶栏最右的电源图标 → 确认框 → 停会话回首页。
- 忘记断开也不要紧：Mac 端在「没有平板在场超过 5 分钟」后会自动停掉虚拟屏；平板再次连上时会自动重新建立，不用手工去 Mac 上开关。
Step 8 · 常见问题
| 现象 | 处理 |
|---|---|
| 平板扫不到 Mac | 确认两端同一局域网 / 网段；把 Mac 的防火墙临时关掉，或在防火墙里放行 VivLink Mac端；重启两端再扫；仍不行用「手动添加」输 IP。 |
| 权限开关开了还是显示未授权 | 用双击或访达打开的方式启动（勿从终端拉起）；必要时在首次设置窗口点主按钮让 App 自动重启一次。 |
| Gatekeeper 拦着打不开，弹窗里没有「打开」 | macOS 15 及以后的正常变化，见 Step 2（系统设置 → 隐私与安全性 → 仍要打开，或用 xattr 命令）。 |
| 画面卡顿 / 不跟手 | 底栏降到 720p；把码率降到 4 / 6 Mbps；Mac 与平板靠近路由器并连 5GHz；关掉占带宽的后台任务。 |
| 回传没反应 | ① 确认底栏最左那格「回传」是绿点（点一下即切换）；② 打开④设置格，看 Mac 侧「辅助功能」那行是不是红色未授权 —— 是的话去 Mac 系统设置里勾上（见 Step 4）。 |
| 在画面上点来点去，控制栏不出来 | 正常。画面区手势已停用（触摸都归 Mac），控制栏请单击画面盒上下的留边区唤出（见 Step 6.1）。 |
| 点「窗口」没反应 / 提示还在连接 | 进小窗要求会话已连上并出画。连接中点它会记住意图、画面就绪后自动进（30 秒内有效）。 |
| 小窗里点了没反应 | 正常。窗口模式下输入全部停用（小窗的触摸事件到不了 App）。要交互请关掉小窗回 App（见 Step 6.4）。 |
| 小窗底部有个播放 / 暂停按钮 | 系统自带、当前 API 去不掉；点它不会暂停会话，无视即可。 |
| 平板切后台画面就停 | 正常：扩展屏需 App 在前台持续收流。想后台保活请用⑤窗口模式（画中画）。 |
| 连上后 Mac 主屏看着变「糊」了（4K 屏尤其明显） | 已知系统行为：连接期间 4K 主屏会降为 1080 —— 属 macOS 虚拟屏行为，摘下即恢复，不影响推流画面，也不是本软件的设置错误。 |
| 平板以前激活过，现在却连不上 Mac | 平板上的「已激活」标记只记录这台平板走过一次激活流程，不等于 Mac 当前已激活。Mac 重装 / 换机 / 清空钥匙串后标记不会自动消失 —— 请打开「激活 Mac 端」页面重新走一次（见 Step 3）。 |
反馈与支持
使用中有问题或建议，欢迎通过 App 内「设置 → 使用反馈」告诉我们；也欢迎加入 App 内「设置 → 用户交流」的用户群。
反馈时请附上：④状态格里那三组数据（尤其 Mac 侧的码率 / 帧率 / 丢包与两项授权状态），以及两端版本号、Mac 型号与 macOS 版本、平板型号与 HarmonyOS 版本、网络情况。