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>
165 lines
5.2 KiB
Go
165 lines
5.2 KiB
Go
package mediaedge
|
|
|
|
import (
|
|
"net"
|
|
"testing"
|
|
"time"
|
|
|
|
"github.com/TNTcraftHIM/Piik/internal/diagnostics"
|
|
"github.com/livekit/livekit-server/pkg/sfu"
|
|
"github.com/pion/rtp"
|
|
"github.com/pion/turn/v5"
|
|
"github.com/pion/webrtc/v4"
|
|
)
|
|
|
|
func testICESocket(t *testing.T, engine *Engine) *iceSocket {
|
|
t.Helper()
|
|
socket, err := engine.newICESocket(nil, false)
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
return socket
|
|
}
|
|
|
|
func TestEngineMediaAddressFamilies(t *testing.T) {
|
|
for _, test := range []struct {
|
|
name, bind, receiver string
|
|
ipv6 bool
|
|
}{
|
|
{name: "default-to-IPv4", receiver: "127.0.0.1:0"},
|
|
{name: "explicit-IPv4", bind: "127.0.0.1:0", receiver: "127.0.0.1:0"},
|
|
{name: "explicit-IPv6", bind: "[::1]:0", receiver: "[::1]:0", ipv6: true},
|
|
} {
|
|
t.Run(test.name, func(t *testing.T) {
|
|
if test.ipv6 {
|
|
probe, err := net.ListenUDP("udp6", &net.UDPAddr{IP: net.IPv6loopback})
|
|
if err != nil {
|
|
t.Skipf("IPv6 loopback UDP is unavailable: %v", err)
|
|
}
|
|
_ = probe.Close()
|
|
}
|
|
engine, err := NewEngine(EngineOptions{BindAddress: test.bind, IncludeLoopback: true})
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
t.Cleanup(func() { _ = engine.Close() })
|
|
source, err := engine.NewSource("vp8", 1, 1, nil)
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
t.Cleanup(func() { _ = source.Close() })
|
|
edge, err := engine.NewEdge(source, EdgeOptions{ConnectionID: test.name})
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
receiver := newReceiverWithAudio(t, false, test.receiver)
|
|
t.Cleanup(func() { _ = receiver.Close() })
|
|
packets := make(chan *rtp.Packet, 1)
|
|
receiver.OnTrack(func(track *webrtc.TrackRemote, _ *webrtc.RTPReceiver) {
|
|
if packet, _, readErr := track.ReadRTP(); readErr == nil {
|
|
packets <- packet
|
|
}
|
|
})
|
|
connectEdgeToReceiver(t, edge, receiver)
|
|
pair, err := edge.sender.Transport().ICETransport().GetSelectedCandidatePair()
|
|
if err != nil || pair == nil {
|
|
t.Fatalf("selected ICE pair is unavailable: %v", err)
|
|
}
|
|
if (net.ParseIP(pair.Local.Address).To4() == nil) != test.ipv6 ||
|
|
(net.ParseIP(pair.Remote.Address).To4() == nil) != test.ipv6 ||
|
|
int(pair.Local.Port) != edge.socket.localPort {
|
|
t.Fatal("ICE selected a different address family or media socket")
|
|
}
|
|
for _, stats := range edge.connection.GetStats() {
|
|
if candidate, ok := stats.(webrtc.ICECandidateStats); ok && candidate.Type == webrtc.StatsTypeLocalCandidate &&
|
|
int(candidate.Port) != edge.socket.localPort {
|
|
t.Fatal("ICE candidate did not use the shared media port")
|
|
}
|
|
}
|
|
if err = writeSourceFrame(source, sfu.VP8KeyFrame8x8, time.Second, time.Second/30); err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
if packet := waitPacket(t, packets); len(packet.Payload) == 0 || !packet.Marker {
|
|
t.Fatal("direct ICE/DTLS transport did not deliver the video frame")
|
|
}
|
|
if err = engine.Close(); err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
if edge.State() != webrtc.PeerConnectionStateClosed {
|
|
t.Fatal("engine shutdown retained its media edge")
|
|
}
|
|
address, err := net.ResolveUDPAddr("udp", edge.socket.mux.LocalAddr().String())
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
reopened, err := net.ListenUDP("udp", address)
|
|
if err != nil {
|
|
t.Fatal("engine shutdown retained its UDP listener")
|
|
}
|
|
_ = reopened.Close()
|
|
})
|
|
}
|
|
}
|
|
|
|
func TestICESocketSTUNUsesOnePortForBothFamilies(t *testing.T) {
|
|
engine, err := NewEngine(EngineOptions{})
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
t.Cleanup(func() { _ = engine.Close() })
|
|
socket := testICESocket(t, engine)
|
|
for _, test := range []struct {
|
|
network string
|
|
ip net.IP
|
|
}{
|
|
{network: "udp4", ip: net.IPv4(127, 0, 0, 1)},
|
|
{network: "udp6", ip: net.IPv6loopback},
|
|
} {
|
|
t.Run(test.network, func(t *testing.T) {
|
|
bound, err := net.ResolveUDPAddr("udp", socket.mux.LocalAddr().String())
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
if test.network == "udp6" && bound.IP.To4() != nil {
|
|
t.Skip("Go selected the supported IPv4-only wildcard socket")
|
|
}
|
|
listener, err := net.ListenUDP(test.network, &net.UDPAddr{IP: test.ip})
|
|
if err != nil {
|
|
if test.network == "udp6" {
|
|
t.Skipf("IPv6 loopback UDP is unavailable: %v", err)
|
|
}
|
|
t.Fatal(err)
|
|
}
|
|
t.Cleanup(func() { _ = listener.Close() })
|
|
server, err := turn.NewServer(turn.ServerConfig{
|
|
PacketConnConfigs: []turn.PacketConnConfig{{PacketConn: listener}},
|
|
LoggerFactory: diagnostics.PionLoggerFactory(),
|
|
})
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
t.Cleanup(func() { _ = server.Close() })
|
|
mapped, err := socket.stunMapping(t.Context(), listener.LocalAddr().(*net.UDPAddr))
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
if mapped.Port != socket.localPort || !mapped.IP.Equal(test.ip) {
|
|
t.Fatal("STUN observed a different socket or address family")
|
|
}
|
|
if test.network == "udp4" {
|
|
observations := 0
|
|
socket.surveySTUN(t.Context(), []webrtc.ICEServer{{URLs: []string{"stun:" + listener.LocalAddr().String()}}},
|
|
func(mapped mappedAddress) {
|
|
observations++
|
|
if mapped.port != socket.localPort || net.ParseIP(mapped.address).To4() == nil {
|
|
t.Error("Native survey did not retain its IPv4 media socket")
|
|
}
|
|
})
|
|
if observations != 1 {
|
|
t.Fatal("Native IPv4 survey did not emit its observation")
|
|
}
|
|
}
|
|
})
|
|
}
|
|
}
|