HarmonyOS Live Streaming: End-to-End Capture, Encoding & Sync Best Practices

Publisher-Side Solutions: From Capture to Encoding

The best practice centers on the publisher (broadcaster) end, where stream quality originates. It covers both audio and video pipelines.

Audio Capture with OHAudio API

OHAudio provides three recording modes: standard recording, voice call, and live streaming recording. Developers select the mode, configure parameters (sample rate, channel count, bit depth), and start the capturer. The document also outlines audio file playback flow and focus management strategies to avoid interruptions.

Video Capture and Encoding

Capture scheme selection: SDR live streams reuse the preview stream, saving power while maintaining color accuracy. Huawei's Hongfeng color algorithm is exposed via a unified recording session interface, delivering standard original-color images. HDR Vivid also reuses the preview stream, suited for low-light or high-dynamic-range scenes, offering wider color gamut, finer gradation, and stronger contrast.

Encoding format and optimization: Surface mode is recommended for its data-flow performance. Region-of-interest (ROI) encoding allocates higher quality to the broadcaster's region while compressing the background, reducing overall bitrate.

Smart control via system pressure feedback: A system pressure callback monitors device load (temperature, CPU/GPU pressure) and dynamically adjusts push bitrate and frame rate to prevent overheating or frame drops.

Viewer-Side Solutions: Playback, Sync, and Stability

The viewer (audience) end focuses on playback core, audio-video synchronization, and long-run stability.

Playback core: HarmonyOS AVPlayer handles both live and on-demand streaming. It supports setting the data source, surface window, and playback parameters (e.g., buffer size, timeout).

Audio-video sync: For common A/V desync, the guide instructs retrieving the audio track's actual presentation timestamp and aligning video frame delivery delay to match audio playback delay, achieving lip-sync.

Stability assurance: The document details memory-leak prevention for the player, critical for long-duration streams to avoid stalls or crashes from resource exhaustion.

Typical Scenario Case Studies

E-commerce live: Color fidelity is paramount. Enable Hongfeng original-color camera for color correction, HDR Vivid for low-light brightness and layering, and ROI encoding to focus bitrate on the host.

Entertainment live: Requires high-fidelity audio and noise suppression. Use high-fidelity recording mode with acoustic echo cancellation (AEC) for PK or duet scenarios, plus ROI encoding to highlight the performance area.

Outdoor live: Subject to weather, lighting, and device thermal constraints. Apply Hongfeng color for outdoor hue accuracy, integrate pressure feedback to auto-adjust bitrate/frame rate based on temperature and system load, and monitor thermal dissipation.

Resources

Best practice document:

https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-hmos-live-stream-solution

Sample code repository:

https://gitcode.com/HarmonyOS_Samples/HMOS_LiveStream