Skip to content

armgit / Piik

Public Imported from GitHub
0

Free, open-source screen sharing for private live streams with friends. Watch together in a browser or self-host Piik. 免费开源的私密屏幕共享,支持游戏直播、一起看电影与自部署。

feat(ui): add local preview controls (#103)

AAAe158e202e36b
diff --git "a/docs/\346\226\271\346\241\210\350\256\276\350\256\241.md" "b/docs/\346\226\271\346\241\210\350\256\276\350\256\241.md"
index 9589fe44..d794b433 100644
--- "a/docs/\346\226\271\346\241\210\350\256\276\350\256\241.md"
+++ "b/docs/\346\226\271\346\241\210\350\256\276\350\256\241.md"
@@ -318,7 +318,7 @@ hop 按[低服务器成本媒体路由](./research/low-server-media-routes.md)
首屏就是工具,不做营销页。视觉采用中性深灰工作台,绿色表示 direct、琥珀色表示 relay/警告、红色表示失败,避免单一蓝紫色主题;浏览器 favicon 复用页头 `MonitorUp` 的深绿底、绿色显示器和上行箭头语言。
- 访问入口:未鉴权根路径、`/join` 和 code-only `/r/{code}` 只显示中性的站点访问验证,未知路径只显示“无法访问”。有效 `/r/{code}#v={grant}` 直接进入;其余 Viewer 通过 site access 后,public-watch 进入房间,private room 再显示中性房间密码输入。无效、过期、错误密码或满员只显示通用拒绝,不泄露房间存在性或 policy。
-- 分享者根页面:顶部显示“{分享者显示名} 的屏幕”和房间状态,并在标题旁显示可单独复制的紧凑房间号;Viewer 同一位置显示权威 Host 名称,不再在标题下重复。主区域保持稳定的 16:9 舞台。未发布、已停止或可恢复错误状态时,舞台内以同等尺寸和权重显示“开始分享”和“加入房间”,中间只用“或”与分隔线表达发送/接收;前者直接开始现有分享流程,后者直接进入 `/join`,不增加首页、向导或拓扑选择。直播时舞台显示本地预览,底部保留停止、同步暂停音视频、质量档位和复制完整邀请链接;暂停只禁用当前 capture stream 轨道并保留连接。
+- 分享者根页面:顶部显示“{分享者显示名} 的屏幕”和房间状态,并在标题旁显示可单独复制的紧凑房间号;Viewer 同一位置显示权威 Host 名称,不再在标题下重复。主区域保持稳定的 16:9 舞台。未发布、已停止或可恢复错误状态时,舞台内以同等尺寸和权重显示“开始分享”和“加入房间”,中间只用“或”与分隔线表达发送/接收;前者直接开始现有分享流程,后者直接进入 `/join`,不增加首页、向导或拓扑选择。直播时舞台显示本地预览及独立全屏图标,底部保留停止、同步暂停音视频、质量档位和复制完整邀请链接;页面失焦仅暂停本地 video element,媒体暂停则禁用 capture stream 轨道,两者都保留现有连接。
- `/join`:通过 site access 后只输入正整数房间码并进入 `/r/{code}`;public-watch 直接通过,private room 缺失 grant 时显示中性房间密码表单。
- `/r/{code}` 观看者:private room 首次解析合法 fragment grant 后立即清理地址栏并直达;仅有 code 时先通过 site access,再按 public/private policy 进入。鉴权后主区域最大化远端视频,标题旁显示可复制的紧凑房间号,顶部保留连接状态,并提供本地音量、静音、全屏和重试控制。
- 移动端:视频保持稳定宽高比,控制与状态移到视频下方,任何文字和按钮不得溢出或遮挡。
diff --git "a/docs/\351\234\200\346\261\202\347\220\206\350\247\243.md" "b/docs/\351\234\200\346\261\202\347\220\206\350\247\243.md"
index 5aff6777..8e62bcbf 100644
--- "a/docs/\351\234\200\346\261\202\347\220\206\350\247\243.md"
+++ "b/docs/\351\234\200\346\261\202\347\220\206\350\247\243.md"
@@ -19,7 +19,7 @@
- [ ] 首屏双入口:分享入口通过站点访问后,主工作区必须同等突出“开始分享”和“加入房间”两个主要动作,并用清楚的视觉分隔表达发送与接收;持合法房间 grant 的观看者不需要知道站点访问密码。点击后直接进入现有分享或房间加入流程,不增加营销首页、模式向导或拓扑选择。浏览器标签页使用与现有 `MonitorUp` 品牌语言一致的 favicon。
- [ ] 简单房间:分享者获得纯数字房间码,但房间码只负责定位。现有 `/r/{code}#v={grant}` 合法未过期邀请继续直接进入;仅有 `/r/{code}` 或 `/join` 房间码的 Viewer 必须先通过站点访问验证,再按房间 policy 进入:public-watch 接受房间码,private room 还需正确观看密码。所有入口只授予该房间 Viewer,不能建房、发布、冒充 Host 或跨房。Host 与 Viewer 标题附近都紧凑、显眼地显示房间号并提供只复制房间号的动作,Host 保留复制完整邀请链接;持久房间码从 `1` 开始自增,其他模式继续使用随机临时房间码。
- [ ] 免安装观看:桌面和手机观看者可直接通过浏览器链接进入、授权并播放,不依赖与分享端相同的桌面客户端。
-- [ ] 屏幕采集:分享者可主动选择显示器或应用窗口,开始、停止、临时同步暂停音视频和切换分享来源;暂停保留现有连接并禁用当前 capture stream 的全部媒体轨道。Host 本地预览必须直接使用 capture stream,不得为预览建立 viewer/媒体边或消耗 TURN、SFU、应用服务器 media egress;预览仍可能产生本地合成、缩放和 GPU 显示成本,不能把隐藏预览称为停止采集或编码。
+- [ ] 屏幕采集:分享者可主动选择显示器或应用窗口,开始、停止、临时同步暂停音视频和切换分享来源;暂停保留现有连接并禁用当前 capture stream 的全部媒体轨道。Host 本地预览必须直接使用 capture stream,支持独立全屏;页面失焦或隐藏时只暂停本地 video element,恢复焦点后继续预览,不得停止 capture、编码或上行。预览不得建立 viewer/媒体边或消耗 TURN、SFU、应用服务器 media egress;预览仍可能产生本地合成、缩放和 GPU 显示成本,不能把隐藏预览称为停止采集或编码。
- [ ] 游戏声音:Windows Chrome/Edge 目标环境可请求系统音频;没有返回音轨时必须明确提示,而不是静默无声。
- [ ] 观看端本地音量:播放控制栏提供 `0%` 至 `100%` 音量条和静音按钮,只改变当前浏览器的媒体元素,不修改 Host 音轨、编码、房间状态或其他观看者。切流、换父和 ICE 恢复保留当前页面内的值;刷新后不持久化。静音保留上次非零音量,拖动到非零值自动取消静音。
- [ ] 本地显示名与房间成员:用户可设置一个只保存在当前浏览器同源 `localStorage` 的显示名;默认以只读文本显示,点击铅笔按钮才进入编辑。Viewer 顶部标题直接显示“{Host 名称} 的屏幕”,不得在下方重复一行 Host 名称。信令只在当前在线 socket 会话内保存和广播 NFC 规范化、最多 24 个 Unicode code points、拒绝控制/换行/双向覆盖符与孤立 surrogate 的纯文本标签,不写 SQLite 或日志。空值使用通用角色 fallback。Host 必须看到全部当前在线 Viewer 的权威总数与 roster,不能拿最多两条 Host 媒体直连数冒充在线人数;presence 更新也不得创建媒体连接。展示身份使用“名称 + 当前房间 `peerId` 的至少六字符短后缀”,房内碰撞时有界延长。显示名、后缀和 `clientId` 都不是账号、授权身份或全局 UUID,重复名称允许且不得参与授权、路由或质量决策。Web Host 与 Viewer 通过同一 opt-in participant roster 看到 Host 名称;Native 不发送 capability,wire 保持不变。
diff --git a/src/client/pages/HostPage.tsx b/src/client/pages/HostPage.tsx
index 1e79875b..0e7606ce 100644
--- a/src/client/pages/HostPage.tsx
+++ b/src/client/pages/HostPage.tsx
@@ -5,6 +5,7 @@ import {
Hash,
KeyRound,
LockKeyhole,
+ Maximize2,
MonitorUp,
Pause,
Pencil,
@@ -313,6 +314,32 @@ export function HostPage({ onAuthorizationRequired }: HostPageProps = {}) {
}
}, [stream]);
+ useEffect(() => {
+ const syncPreviewPlayback = () => {
+ const video = videoRef.current;
+ if (!video) {
+ return;
+ }
+ if (document.visibilityState !== "visible" || !document.hasFocus()) {
+ video.pause();
+ return;
+ }
+ if (streamRef.current) {
+ void video.play().catch(() => undefined);
+ }
+ };
+
+ document.addEventListener("visibilitychange", syncPreviewPlayback);
+ window.addEventListener("blur", syncPreviewPlayback);
+ window.addEventListener("focus", syncPreviewPlayback);
+ syncPreviewPlayback();
+ return () => {
+ document.removeEventListener("visibilitychange", syncPreviewPlayback);
+ window.removeEventListener("blur", syncPreviewPlayback);
+ window.removeEventListener("focus", syncPreviewPlayback);
+ };
+ }, [stream]);
+
useEffect(
() => () => {
activeGenerationRef.current = null;
@@ -685,6 +712,24 @@ export function HostPage({ onAuthorizationRequired }: HostPageProps = {}) {
setNotice(nextPaused ? "音视频分享已暂停" : "音视频分享已恢复");
}
+ async function enterPreviewFullscreen(): Promise<void> {
+ const video = videoRef.current as
+ | (HTMLVideoElement & { webkitEnterFullscreen?: () => void })
+ | null;
+ if (!video) {
+ return;
+ }
+ try {
+ if (video.requestFullscreen) {
+ await video.requestFullscreen();
+ } else {
+ video.webkitEnterFullscreen?.();
+ }
+ } catch {
+ setNotice("当前浏览器无法放大本地预览");
+ }
+ }
+
function removePeer(peerId: string): void {
clearViewerQualityEvidence(peerId);
parentEdgeQualityEvidenceReporterRef.current.forget(peerId);
@@ -1625,7 +1670,18 @@ export function HostPage({ onAuthorizationRequired }: HostPageProps = {}) {
aria-label="分享或加入房间"
>
{stream ? (
- <video ref={videoRef} autoPlay muted playsInline />
+ <>
+ <video ref={videoRef} autoPlay muted playsInline />
+ <button
+ className="icon-button local-preview-action"
+ type="button"
+ title="放大本地预览"
+ aria-label="放大本地预览"
+ onClick={() => void enterPreviewFullscreen()}
+ >
+ <Maximize2 size={18} aria-hidden="true" />
+ </button>
+ </>
) : phase === "idle" ||
phase === "ended" ||
phase === "error" ? (
diff --git a/src/client/styles.css b/src/client/styles.css
index cb499007..fd875f42 100644
--- a/src/client/styles.css
+++ b/src/client/styles.css
@@ -314,6 +314,14 @@ h3 {
background: #050706;
}
+.local-preview-action {
+ position: absolute;
+ z-index: 2;
+ top: 10px;
+ right: 10px;
+ background: rgba(5, 7, 6, 0.78);
+}
+
.stage-placeholder,
.stage-overlay {
position: absolute;