Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

`_ParticipantAudioInputStream` 补静音帧时`data` 长度未乘声道数，多声道配置下抛`ValueError`

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#7,967 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Một pull request liên quan đã được merge.

  • #7968 của @Hugo-DDT — đã merge
  • #7975 của @its-amann — đã đóng, không merge

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
76/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
python
Lĩnh vực
audio-video-rtc, backend

Hướng nghiên cứu

Đọc livekit/agents/voice/room_io/_input.py, đặc biệt là các dòng 390–399 trong _ParticipantAudioInputStream._forward_task, và kiểm tra cách kích thước khung im lặng được tính theo num_channels. Xác nhận độ dài byte dự kiến là num_channels × samples_per_channel × 2; hoàn tất khi có thể tạo khung mà không gặp ValueError với đầu vào đa kênh.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

bug
Bug Description
  • File :livekit/agents/voice/room_io/_input.py
  • Lines : 390–399（_ParticipantAudioInputStream._forward_task 方法尾部）
  • Package : livekit-agents（Python SDK）
Root Cause

当远端音频 track 断流、super()._forward_task() 主循环退出后，子类会补一帧 0.5 秒静音（让下游 VAD/STT 能正确检测到停顿）。这帧的字节数据手工构造时 只按"每样本 2 字节"计算，却漏乘了num_channels ：

Expected Behavior
  • Expected : 无论num_channels 为多少，AudioFrame 的data 长度都应为num_channels × samples_per_channel × 2
  • Actual : data 长度始终为samples_per_channel × 2 ，多声道下触发构造函数校验失败
Reproduction Steps
- 配置`AgentSession` 的`RoomIO` 输入音频为多声道（`num_channels=2` 或更高）——比如`RoomInputOptions(num_channels=2)` 或自定义`VoicePipeline` 里`input_audio_options.num_channels = 2`
- 正常跑通一次对话，让远端 participant 断开 / unmute 停止发布音频
- 触发`_on_track_unsubscribed` →`_close_stream` → 新建 stream 并重启`_forward_task` （或 participant 直接断连，主循环自然结束）
- 立刻抛出`ValueError: data length must be >= num_channels * samples_per_channel * sizeof(int16)`
Operating System

Windows11

Models Used

No response

Package Versions
livekit-agents=1.8.0
Session/Room/Call IDs

No response

Proposed Solution
Additional Context

No response

Screenshots and Recordings

No response

Ngôn ngữ chính
Python
Star
14.6k
Fork
3.9k
Merge trung bình
3 ngày 19 giờ
Pull request đã merge (30 ngày)
204

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của livekit/agents

Tất cả issue của livekit/agents

Issue tương tự

Thêm issue về Python

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.