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.tsxindex 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.cssindex 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;