@ikonai/sdk 1.0.66 → 1.0.68

package/client/ikon-client.d.ts

@@ -141,8 +141,12 @@ export declare class IkonClient {
     private nextProtocolSendPortId;
     private readonly _audioEnabled;
     private readonly _videoEnabled;
-    private readonly _media;
+    private readonly _mediaConfig;
+    private readonly _mediaCaptureConfig;
+    private _media;
+    private _mediaPromise;
     private _mediaCapture;
+    private _mediaCapturePromise;
     private _webRtcSignaling;
     private _webRtcAudioElements;
     private _webRtcAudioStreams;
@@ -161,18 +165,29 @@ export declare class IkonClient {
     private _waitForExternalConnectUrl;
     private _externalConnectUrlCleanup;
     /**
-     * SDK-provided media pipelines (audio/video).
+     * SDK-provided custom (non-WebRTC) media playback pipeline.
      *
-     * Audio and video are always enabled by default. Use this to access audio/video
-     * playback controls and attach rendering surfaces.
+     * This is the backup playback path: when WebRTC carries audio/video (the
+     * default) it is never built and this returns `null`. It is constructed only
+     * when WebRTC is disabled/unavailable. Callers must null-guard.
      */
-    get media(): IkonMedia;
+    get media(): IkonMedia | null;
     /**
-     * Optional SDK-provided media capture pipelines (audio/video/image).
+     * SDK-provided custom media capture pipeline (audio/video/image), if already built.
      *
-     * These are only available in browser environments.
+     * Capture is loaded lazily; use {@link ensureMediaCapture} to build it on demand.
+     * This getter returns `null` until then (and always `null` outside a browser).
      */
     get mediaCapture(): IkonMediaCapture | null;
+    /**
+     * Builds (and caches) the custom media capture pipeline on demand, dynamically
+     * importing its module the first time. Returns `null` outside a browser.
+     *
+     * UI that can trigger capture should call this on mount to warm the chunk so the
+     * later user-gesture click resolves instantly (keeping the gesture intact for iOS).
+     */
+    ensureMediaCapture(): Promise<IkonMediaCapture | null>;
+    private ensureMedia;
     /**
      * Whether audio playback is enabled.
      */
@@ -365,6 +380,12 @@ export declare class IkonClient {
      */
     private setErrorState;
     private connectProtocol;
+    /**
+     * Builds and enables the custom (non-WebRTC) playback pipeline. This is the
+     * backup path used when WebRTC is disabled or its signaling fails; the pipeline
+     * subscribes to the GROUP_AUDIO/GROUP_VIDEO protocol stream once enabled.
+     */
+    private enableCustomPlayback;
     private setupWebRtcSignaling;
     private _webRtcAudioUnlockHandler;
     private readonly _webRtcMediaSession;