Files
Piik/docs/guide
AAA 22864cf311 fix(app,ui): polish handoff links and mobile playback controls
## Problem and outcome

The App console could show a launch address that still contained private activation data when copied, while the terminal hyperlink opened a cleaned address. On narrow phones, playback controls could wrap into a second row and cover too much of the video. The handoff now presents the same safe, activation-preserving address everywhere, and the playback bar keeps one compact row with a shorter flexible volume control.

## Changes

- Sanitize the App activation URL before rendering both copyable console output and terminal hyperlinks, preserving App handoff without exposing credentials.
- Keep the mobile playback bar on one row; let the volume slider shrink with the available width and hide the nonessential percentage readout at the narrowest sizes.
- Add bilingual macOS browser/App audio-capture troubleshooting guidance and record the physical-device boundary.

## Verification

- `npm run check`: TypeScript, 73 test files / 1008 tests, and the Web production build passed.
- `npm run check:go-core`: Go tests, formatting, vet and supported core target builds passed.
- `node scripts/check-docs.mjs` and `scripts/check-project-state.ps1` passed.
- Narrow-layout browser checks covered 320px, 360px, 375px, 390px, 430px, 768px and 1280px widths without wrapping or horizontal overflow.
- The interaction prototype remains local and uncommitted for later acceptance; it is not part of this PR.

## Release notes

### 中文

这是一个维护版本,改善 App 启动链接的安全提示和手机上的播放控制体验。

#### 修复

- 修复 App 控制台复制链接时可能带出私有激活参数的问题。复制、终端链接和手动打开地址现在保持一致,并继续支持自动唤起 App。
- 修复窄屏手机上的播控挤成两行、遮挡画面的问题。控件保持单行,音量滑条会按可用空间缩短,过窄时隐藏非关键的百分比读数。
- 补充 macOS 浏览器与 App 采集声音选项的排查说明,明确不同浏览器和系统版本的能力边界。

#### 兼容性

本版本不改变通信协议、配置格式或存储格式。App 公网邀请、本地模式和已部署站点按原方式更新即可;已打开的页面刷新后使用新的播控布局。

### English

This maintenance release improves App launch links and playback controls on phones.

#### Fixes

- Fixed the App console sometimes exposing private activation parameters in a copied launch address. The copied address, terminal hyperlink and manual URL now match while still supporting App handoff.
- Fixed narrow phone layouts wrapping playback controls into a second row and covering the video. Controls stay on one row, the volume slider shrinks with the available space, and the nonessential percentage readout hides when space is tight.
- Added macOS troubleshooting guidance for browser and App audio capture, including the current browser and OS support boundaries.

#### Compatibility

This release changes no wire protocol, configuration format or storage format. Update the App for public invitations or Local mode, or update the deployed site as usual; refresh an open page to use the new playback layout.
2026-09-18 20:20:53 +08:00
..

Piik documentation

English · 简体中文 · Website

Share your screen with friends, or open their invitation to watch in your browser. Choose a guide for what you want to do.

Start using Piik

I want to… Start here
Watch a friend Open an invitation; no installation needed.
Share my screen Download Piik App, then follow the App steps.
Use Piik without installing Open the online site and follow the online guide.
Use my group's Piik site Connect the App or share in a browser.
Understand App options Modes, platform requirements and diagnostics.

Get help

Troubleshooting covers sound, screen sources, startup and playback. If the page opens but the picture will not connect, start with connection troubleshooting.

Still stuck? Report a problem with your version, system, browser and reproduction steps. The diagnostic guide explains how to collect useful reports.

Run a site for your group

Self-hosting is an advanced option requiring a server, domain and network configuration.

Help improve Piik

Translate Piik, contribute, or explore the developer and maintainer documentation.