第一次用 VeScreen
English · 简体中文 · 回到 VeScreen
VeScreen 支持一位房主分享屏幕，最多 20 位受邀观众通过浏览器观看。 本指南介绍加入房间、使用在线版、使用 VeScreen App，以及通过已有站点分享的方法。
加入房间 · 在线版 · VeScreen App · 已有站点 · 聊天与表情 · 问题排查
观众只需要浏览器和邀请链接。 分享画面推荐下载 VeScreen App，选择 公网邀请。 想免安装，可以打开在线版，直接在浏览器里创建房间并分享。
加入朋友的房间
- 用电脑或手机浏览器打开朋友发来的邀请链接。
- 等待画面出现。如果浏览器没有自动播放，点击 播放。
- 将鼠标移到画面上，或轻点画面，显示播放控制栏。
播放控制栏只改变你自己看到的画面和听到的声音。 电脑上单击画面可暂停或继续，双击可进入或退出全屏（浏览器支持时）。 手机上轻点画面唤出控制栏，再使用其中的按钮。Safari 的视频全屏可能使用系统播控。
播放按钮分别做什么？
| 按钮 | 作用 |
|---|---|
| 剧场模式 | 在浏览器标签页内展开画面。 |
| 全屏观看 | 全屏显示并保持原始比例；画面与屏幕比例不同时会留边。 |
| 悬浮小窗 | 浏览器支持时，把视频放进独立小窗。 |
| 音量 | 支持增强时最高 200%，否则最高 100%；声音失真时调低一些。 |
只有四位房间号时，打开同一个 VeScreen 站点，选择 加入房间。 你可能需要站点口令和房间密码。能否通过房间号加入由房主决定； 无法加入时，请朋友发邀请链接。
房主可关闭链接旁的 免密邀请，复制普通房间地址。访客打开地址后按站点和房间设置 验证口令或密码；仅限邀请的房间需保留凭证。这个开关不会撤销已发出的邀请。
旧链接失效了，就请房主重新发一份当前邀请。 App 的本地房间和临时公网邀请会随本次 App 退出而结束。
使用在线版
- 在浏览器中打开 demo.piik.tv。
- 点击 开始分享，选择 浏览器 分享屏幕、窗口或标签页；也可在电脑或手机上选择 摄像头（需浏览器支持访问）。如需来源声音且选择器提供该选项，启用音频。
- 确认预览后，点击 复制邀请链接，用另一台设备打开，或发送给朋友。
- 分享结束后，点击 停止分享。
在线版由项目提供，画面仅通过设备间直连（P2P）传输。 在受限网络下，可能出现页面能打开、画面无法连接的情况。
用 VeScreen App 分享
- 从 GitHub Releases 或 Gitee 镜像下载以
piik-app开头、 对应平台的压缩包，完整解压并保留目录结构。 - Windows 打开
piik-app.exe，macOS 打开VeScreen.app，Linux 运行./piik-app。 启动页会在系统浏览器里打开。 - 邀请不在同一局域网的朋友时，选择 公网邀请，再点击 进入 VeScreen。 其他模式的用途见下表。
- 点击 开始分享，按可用选项选择 浏览器、摄像头、程序 / 窗口 或 屏幕， 然后选定要分享的画面与声音。
- 复制房间邀请发给朋友。分享期间保持 App 和分享标签页打开。
启动页提示更新时，可点击 版本说明 查看 GitHub 或 Gitee 上的详情。 跨大版本更新会显示兼容性提醒；替换 App 前，请先阅读升级说明。
| 文件名包含 | 适用平台 |
|---|---|
windows-amd64 | Windows x64 |
darwin-arm64 | Apple 芯片；原生采集需 macOS 13 及以上 |
darwin-amd64 | Intel Mac；原生采集需 macOS 13 及以上 |
linux-amd64 | Linux x64 |
linux-arm64 | Linux ARM64 |
目前主要测试 Windows 版 VeScreen App 和浏览器分享。macOS 和 Linux 版 VeScreen App 仍需更多实机测试， 欢迎有设备的朋友试用并反馈问题。 Linux 原生采集还需要系统组件。 程序包与启动参数的细节见 App 指南。
选择 App 模式
| 模式 | 什么时候用 | 需要知道 |
|---|---|---|
| 本地房间 | 朋友和你在同一个局域网。 | 出现多个「局域网邀请地址」时，选择与朋友同一网络的网卡和 IP。对方需要能连接到你的电脑，可以设置本地站点口令。 |
| 公网邀请 | 朋友在别处，想临时发个邀请。 | 需要互联网连接；公网地址只在本次 App 运行期间有效。 |
| 连接站点 | 你们已经有一个 VeScreen 站点。 | 输入站点地址，在原有分享页面使用 App 的采集能力。 |
本地房间和公网邀请可展开 站点口令 设置可选的访问口令。
使用 连接站点 时，输入域名（例如 demo.piik.tv）或粘贴完整网址，然后点击 进入 VeScreen。 省略前缀时自动使用 HTTPS；HTTP 站点请填写 http://。 如果站点要求访问口令，在打开的站点页面输入。通过 App 打开过一次后，同一浏览器会记住这个入口。 保持 App 运行并使用该站点配置，之后就能直接访问网址。点击 开始分享， 在选择器里选 程序 / 窗口 或 屏幕，即可使用 App 采集。 浏览器询问本地网络权限时，请允许访问。换浏览器、使用无痕窗口或清除站点数据后， 需要重新从 App 进入一次；换用其他站点时，先在 App 中更新地址。
网页能打开，不代表视频一定能连通。 公网邀请为房间提供临时网页地址， 画面和声音仍靠参与者之间的连接传输。此模式没有媒体服务器兜底， 临时地址也不保证持续可用。所有模式都需要可用的 UDP 媒体路径。 具体连接方式见 App 指南。
使用已有站点分享
需要先有一个运行 VeScreen Server 的 HTTPS 站点，可以使用朋友或管理员提供的地址。 也可以使用项目提供的在线版或 VeScreen App。 自建站点属于进阶操作，服务器、HTTPS 和网络端口的配置步骤见部署指南。
- 打开 VeScreen 站点。如果站点设置了口令，先输入口令。
- 点击 开始分享，选择 浏览器 后在浏览器弹窗里选择屏幕、窗口或标签页； 浏览器支持时，电脑和手机也可选择 摄像头。如需来源声音且选择器提供该选项，启用音频。
- 确认预览画面后，点击 复制邀请链接 发给朋友。
- 保持分享标签页打开。需要时使用 暂停分享、切换来源 或 停止分享。
浏览器屏幕采集需要 HTTPS 站点或 localhost。 弹窗里有哪些画面和声音可选，取决于浏览器与操作系统。 拿到邀请链接的人可以进入这个房间，请把它发给你想邀请的人。
想在同一站点使用 App 采集，可按连接站点的步骤操作。 站点负责房间与邀请，App 提供原生采集。 如果管理员已启用 SFU 转发，房主可在开始分享前关闭 隐私模式，允许使用这条兜底线路。 项目提供的在线版仅使用 P2P。
加上自己的声音
分享时，点击画面下方的 麦克风，并允许访问。 再次点击即可静音。在画面下方的 设置 → 声音 中可以选择麦克风和调节输入音量，默认 100%，最高可调至 200%。 观众会同时听到来源声音和你的解说；房主本机预览保持静音。
摄像头分享不会自动开启麦克风。App 的 程序 / 窗口 和 屏幕 采集也使用同一组控件， 可以保留「默认设备」，也可以指定麦克风。在 摄像头 页签中允许访问后，点击对应的画面卡片开始分享。 设备名称和可用预览取决于浏览器权限；正在分享摄像头时，其他摄像头只显示名称。 建议佩戴耳机，避免扬声器声音被麦克风再次收进去。
通过 浏览器 或 摄像头 分享时，声音设置中的 降噪与回声消除 默认开启， 由浏览器处理回声、杂音和音量。输入音乐或虚拟音频设备的声音时，可关闭它； 设备及系统自身的音效仍由各自设置控制。App 原生采集使用设备及系统的音频设置。
带麦克风的摄像头仍需分别选择画面和音频输入。OBS 虚拟摄像头只提供画面； 如需带上 OBS 的声音，可按 OBS 音频转接教程 设置虚拟音频设备，再在 VeScreen 的麦克风列表中选择对应输入并开启麦克风。
分享屏幕时排除语音软件的声音
在支持此功能的 Windows App 中，打开 屏幕 页签并开启 系统声音， 在 排除应用声音 中选择语音软件的窗口，再选择要分享的屏幕。 未列出的应用请先打开窗口，再刷新。此功能排除所选进程及其子进程， 其他应用的声音仍会被分享，包括输出到其他播放设备的声音。 它不影响 VeScreen 麦克风，也不能消除扬声器被麦克风收音产生的回声。
开播后，可在 分享设置 → 声音 中调整系统声音和排除的应用，无需停止分享。 所选应用关闭或重启后，来源声音会停止；请刷新应用列表并重新选择。 暂时关闭来源声音会保留排除选择；需要恢复完整的系统声音时，选择 不排除。 此控件需要新版页面和通过进程排除能力检测的 Windows App，不适用于浏览器自带的分享选择器。 Windows 10 是否支持取决于系统更新与实际检测；未显示此选项时，可改为分享单个应用窗口，或将语音软件输出到另一播放设备。
聊天与表情
房主首次开始分享、创建房间后，参与者可以点击沙发下方的 聊天 发送消息。 点击沙发上的人物可打开表情菜单：给自己发的表情出现在头顶，送给朋友的表情会飞向对方。 聊天窗口可以移动和缩放，不会挤动页面。
输入框旁和观众播放控制栏中的 弹幕 可以把新消息显示在画面上，默认关闭，只影响自己的观看。 打开聊天窗口中的 聊天设置，可以调整弹幕字号和不透明度。 系统视频全屏和画中画无法显示弹幕。
停止分享后仍可继续聊天；App 的本地房间和公网邀请需要保持 App 运行。 每个页面只保留本页最近收到的消息，刷新后清空，后来加入的人看不到此前的记录。 需要留存时，可通过 聊天设置 → 导出聊天记录 将本页保留的最近消息（最多 1,000 条）保存为文本文件。 聊天消息经过房间所在的服务器，不提供端到端加密。
遇到问题了
声音、采集、启动或播放遇到问题时，先看问题排查。
画面连接不上
出现「没有可用的媒体线路」等提示时，参阅画面连接排查。