AAAandPedro Antonio
c18502fd18
This release adds microphone processing controls and local chat controls, expands platform packages, and synchronizes the website and guides. It also fixes native H.264 input/format handling, signaling recovery, fresh STUN discovery, and UDP ownership during overlapping connections. This is **v1.8.0**. Browser/Server v23, Native control v9 and capture v7 remain unchanged, with the existing 1440p ceiling. Additional resolutions, capability negotiation and Magicsock are separate follow-up work. ## Validation - Full local Web check: 79 files / 1,317 tests, TypeScript and production build. - Full Go checks, platform builds and Windows native capture regressions/probe. - Native H.264 Host lifecycle, Browser-to-App fanout and App-exit recovery, and Native H.264 through embedded SFU: all passed with owned process/port/profile cleanup. - Website build, documentation and repository hygiene passed. Existing UI acceptance covers narrow screens, both languages/themes, architecture downloads and all 23 film checks; final packaging and Go race checks run on the merged revision in CI. - Physical macOS/Linux capture, representative public networks and unmatched field reports retain their documented evidence limits. No claim that every blur/disconnection report is resolved. ## Release notes ### 中文 这是一次功能与兼容性更新：麦克风和聊天增加了实用的小选项，App 与 Server 支持更多设备，同时修复了原生分享和连接恢复中的若干问题。现有 1.x 协议保持不变。 #### 新增与改进 - 浏览器麦克风新增「降噪与回声消除」开关，默认开启回声消除、降噪和自动增益；分享音乐或使用虚拟音频输入时，可按需关闭。 - 可调整弹幕字号和透明度，并将当前保留的聊天记录导出为 TXT。当前会话最多保留 1,000 条文字消息，刷新页面后清空；需要保存时请先导出。 - 新增 Intel Mac、Linux ARM64 App，以及 Linux ARM64 Server 和容器镜像。官网下载区可直接选择对应架构，并显示最新版本和发布时间。 - 更新官网演示、README 截图和中英文教程，明确浏览器分享也可选择窗口或屏幕；开始分享前显示房间号占位，保持底栏控件位置稳定。 - 官网新增直达问题排查的入口，补充浏览器 WebRTC 限制、校园网和 Windows 显卡相关的排查步骤。 - App 模式选择页显示免费开源说明、作者与贡献者署名，以及官方网站和源码链接。 #### 修复 - 修正部分 H.264 原生分享的格式兼容性校验，以及 Windows 编码器输入长度和输出缓冲区对齐问题。 - 清理已失效的重连任务和 Native 接收信令，避免旧连接继续影响当前会话。 - 修复 App 重连时可能复用过期公网地址的问题；重新探测使用当前地址，并处理探测丢包和过期响应，保留其他正常连接。 - 修复 App 新旧媒体连接重叠时共用端口造成的冲突，避免准备或撤销新连接打断仍在使用的画面；关闭连接时及时取消未完成的端口映射请求。 - 无站点密码时，连接恢复不再误引导用户输入站点密码。 - 房间失效或会话终止时，开播前后的原因提示统一显示在电视状态图标中，避免额外提示条。 - 修正 Linux 原生采集的时间戳与关键帧时间基准。感谢 Pedro Antonio 在 [#449](https://github.com/TNTcraftHIM/Piik/pull/449) 的贡献。 #### 使用说明 下载对应平台的完整压缩包，退出旧 App 后解压使用。Windows 继续提供 x64；macOS 提供 Apple 芯片与 Intel 版本，原生采集需要 macOS 13 或更新版本。Linux 提供 x64 与 ARM64，原生采集还需安装[系统组件](https://github.com/TNTcraftHIM/Piik/blob/main/native/capture/linux/README.md)。macOS 和 Linux 的实机覆盖仍有限，欢迎反馈。 ### English This update adds useful microphone and chat controls, brings Piik to more devices, and fixes several native-sharing and connection-recovery issues. The existing 1.x protocols remain unchanged. #### New and improved - Browser microphones now have a “Noise & echo reduction” toggle. Echo cancellation, noise suppression and automatic gain control are on by default; turn them off when appropriate for music or virtual audio inputs. - Adjust chat-overlay text size and opacity, and export retained messages as TXT. The current session keeps up to 1,000 text messages and clears on page refresh; export first if you want to keep them. - Added Intel Mac and Linux ARM64 App packages, plus Linux ARM64 Server and container images. The website provides architecture selectors and shows the latest release and publication date. - Updated the website demonstration, README screenshots and bilingual guides, clarifying that browser capture can also select windows or screens. A room-code placeholder keeps the bottom bar stable before sharing starts. - Added direct website links to troubleshooting, with steps for browser WebRTC restrictions, campus networks and Windows graphics issues. - The App mode-selection page now shows its free and open-source status, author and contributor credit, and links to the official website and source. #### Fixes - Corrected H.264 format compatibility checks and Windows encoder input-length and output-buffer alignment handling. - Retired stale reconnect tasks and Native receive signals so they cannot continue affecting the current session. - Fixed App reconnection reusing an expired public address. Fresh discovery handles lost probes and stale responses while preserving other working connections. - Fixed UDP socket conflicts between overlapping App media connections so preparing or canceling a replacement preserves the active picture. Closing a connection now cancels unfinished gateway mapping requests. - Connection recovery on passwordless sites no longer incorrectly asks for a site passphrase. - Expired-room and session-termination reasons now use the same TV status indicator before and during sharing, without an extra notice strip. - Corrected Linux native capture timestamps and keyframe time bases. Thanks to Pedro Antonio for [#449](https://github.com/TNTcraftHIM/Piik/pull/449). #### Updating Download the complete archive for your platform, quit the old App, and extract the new package. Windows remains x64-only. macOS packages support Apple silicon and Intel; native capture requires macOS 13 or newer. Linux supports x64 and ARM64 and requires additional [system components](https://github.com/TNTcraftHIM/Piik/blob/main/native/capture/linux/README.md) for native capture. Physical-device coverage on macOS and Linux remains limited; feedback is welcome. ## Attribution Co-authored-by: Pedro Antonio <wrenchwastaken@gmail.com>
42 lines
2.2 KiB
Markdown
42 lines
2.2 KiB
Markdown
# Piik 文档中心
|
||
|
||
[English](./README.md) · 简体中文 · [官网](https://piik.tv/?lang=zh-CN)
|
||
|
||
分享自己的屏幕，或者打开朋友的邀请链接，在浏览器里一起看。
|
||
按你想做的事，选择下面的指南。
|
||
|
||
## 开始使用
|
||
|
||
| 我想…… | 从这里开始 |
|
||
| --- | --- |
|
||
| 看朋友的分享 | [打开邀请链接](./getting-started.zh-CN.md#加入朋友的房间)，无须安装。 |
|
||
| 分享自己的屏幕 | [下载 Piik App](https://piik.tv/?lang=zh-CN#download)，再按 [App 使用步骤](./getting-started.zh-CN.md#用-piik-app-分享)操作。 |
|
||
| 免安装使用 | 打开[在线版](https://demo.piik.tv)，参阅[在线版教程](./getting-started.zh-CN.md#使用在线版)。 |
|
||
| 使用已有的 Piik 站点 | [配合 App 使用，或直接在浏览器中分享](./getting-started.zh-CN.md#使用已有站点分享)。 |
|
||
| 了解 App 的选项 | [运行模式、平台要求与诊断](../../cmd/piik-app/README.zh-CN.md)。 |
|
||
|
||
## 遇到问题
|
||
|
||
[问题排查](./troubleshooting.zh-CN.md)按遇到的现象提供处理步骤，常用入口：
|
||
|
||
- [画面连接不上](./troubleshooting.zh-CN.md#画面连接不上)，包括 WebRTC 设置与校园网问题。
|
||
- [H264 分享失败与显卡排查](./troubleshooting.zh-CN.md#windows-上-h264-分享失败)。
|
||
- [App 找不到来源](./troubleshooting.zh-CN.md#app-找不到窗口或屏幕)或[创建房间返回 403](./troubleshooting.zh-CN.md#创建房间返回-403)。
|
||
|
||
仍然没解决？可以[反馈问题](https://github.com/TNTcraftHIM/Piik/issues/new/choose)，
|
||
附上版本、系统、浏览器和复现步骤。需要收集报告时，参阅
|
||
[诊断说明](../../cmd/piik-app/README.zh-CN.md#诊断)。
|
||
|
||
## 为朋友搭建站点
|
||
|
||
自部署属于进阶操作，需要服务器、域名和网络配置。
|
||
|
||
- [部署 Piik Server](../operations/self-hosting.zh-CN.md)：使用 Docker Compose 或服务端程序包。
|
||
- [长期运行与更新](../operations/service-management.zh-CN.md)。
|
||
- [完整配置参考（英文）](../standards/configuration.md)。
|
||
|
||
## 一起改进 Piik
|
||
|
||
可以从[参与翻译](./translating.zh-CN.md)、[贡献指南](../../CONTRIBUTING.md)，
|
||
或[开发与维护文档](../README.md)开始。
|