@naviedu/room-platform-react 0.0.85 → 0.0.87

package/README.md

@@ -63,6 +63,17 @@ export function Room({ launchToken }: { launchToken: string }) {
 
 `RoomPlatformProvider` is advanced composition only; a consumer using it instead of `RoomPlatformRoom` owns its own DOM and stylesheet boundary.
 
+## Camera preview mirror
+
+The local camera preview is mirrored by default to preserve the existing local
+experience. The `Lật ngang video xem trước` setting is available under
+`Thiết lập` → `Thiết bị` and is stored locally; it affects only how the current
+user sees their own preview.
+
+Turning the setting off changes only the local preview. Background processor
+input, remote participants, the stage, and recordings always use the original
+orientation.
+
 ## Framework-neutral room control
 
 Use the React-free subpath when a host needs the shared room-control contracts

package/index.d.ts

@@ -49,7 +49,7 @@ export declare function getRoomPlatformPrivateRoomStatusBanner({ privateRoom, is
     privateRoomReturnedNoticeId?: string;
 }): RoomPlatformPrivateRoomBannerState | undefined;
 
-export declare const monitorCameraVideoClassName = "h-full w-full object-cover -scale-x-100";
+export declare const monitorCameraVideoClassName = "h-full w-full object-cover";
 
 declare type OmitUndefined<T> = T extends undefined ? never : T;
 
@@ -394,9 +394,10 @@ export declare type RoomPlatformLocalMediaKind = 'microphone' | 'camera' | 'scre
 
 declare type RoomPlatformLocalMediaState = Record<RoomPlatformLocalMediaKind, boolean>;
 
-export declare function RoomPlatformLocalPreview({ trackRef, localTrack, }: {
+export declare function RoomPlatformLocalPreview({ trackRef, localTrack, mirrorVideoPreview, }: {
     trackRef?: TrackReference;
     localTrack?: LocalVideoTrack | null;
+    mirrorVideoPreview?: boolean;
 }): JSX.Element;
 
 export declare function RoomPlatformMediaRuntime({ children }: PropsWithChildren): JSX.Element;
@@ -647,7 +648,7 @@ export declare type RoomPlatformTopBarProps = {
     topBarTrailing?: ReactNode;
 };
 
-export declare function RoomPlatformVideoTile({ kind, label, trackRef, className, media, mediaClassName, labelPosition, onLoadedMetadata, onResize, }: RoomPlatformVideoTileProps): JSX.Element;
+export declare function RoomPlatformVideoTile({ kind, label, trackRef, className, media, mediaClassName, labelPosition, mirrored, onLoadedMetadata, onResize, }: RoomPlatformVideoTileProps): JSX.Element;
 
 export declare type RoomPlatformVideoTileKind = 'active-speaker' | 'overlay' | 'preview' | 'stage';
 
@@ -659,6 +660,7 @@ export declare type RoomPlatformVideoTileProps = {
     media?: ReactNode;
     mediaClassName?: string;
     labelPosition?: 'bottom-left' | 'top-left';
+    mirrored?: boolean;
     onLoadedMetadata?: ReactEventHandler<HTMLVideoElement>;
     onResize?: ReactEventHandler<HTMLVideoElement>;
 };
@@ -708,6 +710,8 @@ declare type RoomPrivateRoomStatus = 'ringing' | 'active';
 export declare function useRoomPlatform(): RoomPlatformContextValue;
 
 declare function useRoomPlatformCameraBackground({ localVideoTrack, onProcessorSettled, }: UseRoomPlatformCameraBackgroundInput): {
+    mirrorVideoPreview: boolean;
+    setMirrorVideoPreview: (enabled: boolean) => void;
     state: RoomPlatformCameraBackgroundState;
     uploadItems: RoomPlatformCameraBackgroundUploadPreview[];
     uploadPreviewUrl: string;