1.0.5

What's New

• Added local-file video generation for TRTC, Agora and VeRTC. Files are decoded through Canvas and Web Audio without requesting camera or microphone access; audio and looping are enabled by default.
• Local-file input sizes automatically fit the nearest model resolution by aspect ratio, with proportional scaling and letterboxing. Camera and network-video size validation are unchanged.
• Added network-video generation: the server reads a video URL while the client receives generated media without publishing local audio or video.
• Added non-realtime video tasks, ordinary video uploads and browser video downloads.
• Reference selection in X-Lab no longer dims and disables the entire reference area during generation-condition updates; consecutive selections use the existing selection queue.

API Changes

• Added createLocalVideoStream({ file, videoFormat, loop?, includeAudio? }) and createNetworkVideoStream({ url, videoFormat, sampleMethod?, onFinish? }) to the realtime manager.
• Added RealtimeContext.referenceVideo and RealtimeVideoSampleMethod for network-video sources.
• Added createNonRealtimeManager() for task submission, querying, listing and completion polling. Task submission requires an explicit model.
• Non-realtime tasks use dedicated China/global endpoints: https://api.xmaxai.com/open/api/v1/offline-task and https://api.xmax.ai/open/api/v1/offline-task.
• Added storage-service uploadVideo() and downloadVideo() methods.
• Added RealtimeModelName for custom server model identifiers. Unknown models retain their original name and use the local defaults of x2.1-preview, unless an RTC provider is explicitly selected.
• The default RTC provider for x2.0 is VeRTC. Removed the built-in x2_0_pro and x2_1_preview_1005 enum members and their preset configuration; migrate enum references before upgrading.

Requirements and Known Limitations

• Local-file decoding depends on browser codec support, Canvas capture and Web Audio. Invoke source creation from a user gesture and keep the page foregrounded for stable frame delivery.
• Playback starts after the generation start signal is sent, not after a server input-readiness acknowledgement; processing every initial frame is not guaranteed. Local preview remains silent while file audio is published.
• Network video URLs must be accessible to the server; browser preview and download additionally depend on browser media and CORS restrictions.
• Actual RTC resolution, frame rate and bitrate can vary with device, browser and network conditions. The new TRTC and VeRTC file-source paths have automated coverage but have not been verified against live generation services in this release workflow.
• Full release CI and isolated consumer build validation were skipped at the maintainer's request. The release package was built with version 1.0.5 and its contents and checksums were inspected; this is not a full release-validation pass.