Skip to content

1.0.4

Choose a tag to compare

@WengYuehTing WengYuehTing released this 09 Oct 04:41
· 41 commits to main since this release

What's New

  • Added Agora and Volcengine VeRTC alongside the existing TRTC transport, with shared mobile video-orientation handling.
  • Added runtime uplink video-format updates: change encoding resolution, frame rate and bitrate without reconnecting or restarting generation. Successful settings are reused on reconnect; generation and remote interpolation retain the original format.
  • X-Lab now keeps each reference category mounted with an independent scroll position on mobile and desktop. Reference selection is global, and submitting a free-mode prompt clears selections from other categories.
  • X-Lab model labels are now X2.1-preview-trtc, X2.1-preview-agora and X2.1-preview-vertc; API model identifiers and routing are unchanged.

API Changes

  • Added RealtimeConfiguration.provider with RtcProvider.trtc, RtcProvider.agora and RtcProvider.vertc. TRTC remains the default; the provider is fixed for a manager's lifetime.
  • Added RealtimeModel.x2_0_agora (x2.0-agora) and RealtimeModel.x2_1_preview (x2.1-preview). Both currently use the model-specific dev session API at https://dev.xmaxai.com/open/api/v1.
  • Added XmaxRealtimeManaging.updateVideoFormat(videoFormat). Call after creating the local camera stream and await completion before another configuration or lifecycle operation. Supply a complete format; omitted optional values use SDK defaults.
  • Video-format validation now rejects non-finite frame rates and bitrate values.
  • Removed RealtimeModel.x2_0_pro (x2.0-pro). Applications referencing this enum member must select a supported model and the matching RTC provider before upgrading.

Requirements and Known Limitations

  • Camera and microphone require an HTTPS or localhost secure context and user permission. Audio playback remains subject to browser autoplay policies.
  • Actual sent resolution, frame rate and bitrate depend on the device, browser, RTC provider and network. Use statistics callbacks to observe the effective values.
  • Interpolation requires WebGPU, shader-f16 and requestVideoFrameCallback; support and performance vary by browser and device.
  • Automated validation does not substitute for live camera, RTC, audio, interpolation and reconnect testing on target devices. The release process does not run live service sessions.