educast-classroom-sdk 1.0.0

package/lib/infra/stores/common/stream-window/index.d.ts

@@ -0,0 +1,223 @@
+import { EduStream } from 'agora-edu-core';
+import { IReactionDisposer, Lambda } from 'mobx';
+import { DraggableData } from 'react-draggable';
+import { EduUIStoreBase } from '../base';
+import { StreamBounds } from '../stream/struct';
+import { StreamWindowWidget } from './struct';
+import { StreamWindow } from './type';
+export declare class StreamWindowUIStore extends EduUIStoreBase {
+    private _dataStore;
+    protected _disposers: (IReactionDisposer | Lambda)[];
+    private _snapshotPosition;
+    private _streamWindowFirstOffset;
+    private _streamWindowUpdatedFromRoom;
+    private _lowUuids;
+    private _highUuids;
+    private _streamWindowContainerBounds;
+    get minRect(): {
+        calculateCount: number;
+        minWidth: number;
+        minHeight: number;
+    };
+    get streamDraggable(): boolean;
+    get needDraggable(): boolean;
+    /**
+     *
+     */
+    get streamWindowMap(): Map<string, StreamWindowWidget>;
+    /**
+     *
+     */
+    get transitionStreams(): Map<string, boolean>;
+    /**
+     *
+     */
+    get tempStreamWindowPosMap(): Map<string, StreamWindowWidget>;
+    /**
+     * 正在拖拉的 streamUuid
+     */
+    get draggingStreamUuid(): string;
+    /**
+     * 讲台状态
+     */
+    get stageVisible(): boolean;
+    get streamWindowStreamUuids(): string[];
+    get streamWindowRealBoundsMap(): Map<string, StreamWindow>;
+    /**
+     *  用于 UI 展示
+     */
+    get streamWindows(): [string, StreamWindow][];
+    /**
+     * 是否有全屏展示的 streamWindow
+     */
+    get containedStreamWindow(): StreamWindowWidget | undefined;
+    /**
+     * 覆盖组件透明度（底部工具栏，侧边工具栏，举手按钮，聊天按钮）
+     */
+    get containedStreamWindowCoverOpacity(): 1 | 0.9;
+    /**
+     * 全屏展示的 streamWindow 数量
+     */
+    get containedStreamWindowSize(): number;
+    /**
+     * 返回没有在指定区域展示的 streams
+     */
+    get streamsShouldOffPodium(): EduStream[];
+    /**
+     * 小流ID
+     */
+    get lowStreamUuids(): Set<string>;
+    /**
+     * 拖拉权限控制
+     */
+    streamWindowLocked: (stream: EduStream) => boolean;
+    /**
+     * 是否存在 streamWindow widget
+     * true 代表大窗里有 stream
+     * false 代表大窗里没有 stream
+     */
+    visibleStream: (streamUuid: string) => boolean;
+    /**
+     * 设置大窗显示区域
+     * @param bounds
+     */
+    setMiddleContainerBounds(bounds: StreamBounds): void;
+    /**
+     * for drag
+     * @param param0
+     */
+    setStreamDragInformation({ stream, active, pos, }: {
+        stream: EduStream;
+        active: boolean;
+        pos: [number, number];
+    }): void;
+    /**
+     * 是否在多视频的容器内
+     * @param x
+     * @param y
+     * @returns
+     */
+    private _isMatchWindowContainer;
+    private _createStreamWindowByUuid;
+    private _addStreamWindowByUuid;
+    private _removeStreamWindowByUuid;
+    private _initStreamWindowSize;
+    /**
+     * 从小视频向拉创建 stream window
+     * @param streamUuid
+     */
+    private _createStreamWindow;
+    /**
+     *
+     * @param streamUuid
+     * @param pos
+     */
+    private _updateStreamWindow;
+    private _setValidStreamWindowOffset;
+    /**
+     * 值都是具体的数值
+     * @param streamUuid
+     * @param param1
+     */
+    private _setStreamWindowMap;
+    private _handleTempStreamWindowMap;
+    _setStreamWindowUpdate(status: boolean): void;
+    /**
+     * 双击视频窗口逻辑处理
+     * @param stream
+     * @returns
+     */
+    handleDBClickStreamWindow(stream: EduStream): void;
+    /**
+     * 双击全屏的时候
+     * 1. 讲台展示直接删除 streamwindow widget，
+     * 2. 讲台隐藏的时候需要查看之前窗口的位置，
+     *  2.1 如果有位置那么返回之前的位置
+     *  2.2 如果么位置那么创建一个位置不要重叠
+     * @param stream
+     * @returns
+     */
+    handleStreamWindowContain(stream: EduStream): void;
+    /**
+     * 设置重新计算后的 widget rect
+     * 需要要没有全屏的 widget 删除
+     */
+    private _handleCalculateContains;
+    /**
+     * 单击处理 zIndex 问题
+     * @param streamUuid
+     */
+    handleStreamWindowSingalClick(stream: EduStream): void;
+    /**
+     * https://github.com/facebook/react/issues/3185
+     * @param streamUuid
+     * @returns
+     */
+    handleStreamWindowClick(stream: EduStream): () => void;
+    private _calculateSize;
+    /**
+     * 获取全屏的视频
+     */
+    private _getStreamWindowContain;
+    setTransitionStreams(streamUuid: string): void;
+    removeTransitionStreams(streamUuid: string): void;
+    private _handleStageStreamAdded;
+    private _handleStageStreamRemoved;
+    private _handleClassroomUIEvents;
+    private _handleOffAllStreamWindow;
+    private _handleToggleTeacherStreamWindow;
+    /**
+     * 发送数据到远端，teacher only
+     */
+    sendWidgetDataToServer(streamUuid?: string): void;
+    /**
+     * 删除 widget streamwindow
+     * @param widgetUuid
+     */
+    private _deleteStreamWindowWidgetToServer;
+    /**
+     * for stream window drag
+     * @param e
+     * @param data
+     * @param streamUuid
+     * @param offsetX
+     * @returns
+     */
+    handleDrag(e: any, data: DraggableData, streamUuid: string, offsetX: number): void;
+    /**
+     * 区域内更新 streamsWindowMap 信息
+     * @param streamUuid
+     * @param streamWindowInfo
+     */
+    handleStreamWindowInfo(stream: EduStream, streamWindowInfo: {
+        x?: number;
+        y?: number;
+        width?: number;
+        height?: number;
+        zIndex?: number;
+        contain?: boolean;
+    }, sendToServer?: boolean): void;
+    private _handldeStreamWindowCollisionDetection;
+    /**
+     * 转换为 widget 坐标
+     * @returns
+     */
+    private _encodeWidgetRect;
+    private _createNewTempStreamWindow;
+    private _getTempStreamWindowPosCache;
+    private _handleToggleWhiteboard;
+    private _setRemoteStreamType;
+    removeStreamWindowByUuid(streamUuid: string): void;
+    handleWidgetInformationFromServer(widgets: any): void;
+    updateDraggingStreamUuid(streamUuid: string): void;
+    resetDraggingStreamUuid(): void;
+    /**
+     * 转换 widget 坐标方式
+     * @param widgetProps
+     * @returns
+     */
+    private _decodeWidgetRect;
+    private _setEventHandler;
+    onInstall(): void;
+    onDestroy(): void;
+}

package/lib/infra/stores/common/stream-window/struct.d.ts

@@ -0,0 +1,95 @@
+/**
+ * streamWindow widget
+ */
+export declare class StreamWindowWidget {
+    width: number;
+    height: number;
+    x: number;
+    y: number;
+    /**
+     * view 层级关系
+     */
+    zIndex: number;
+    /**
+     * 是否填充到多视频区域
+     */
+    contain: boolean;
+    constructor({ width, height, x, y, zIndex, contain, }: {
+        width?: number;
+        height?: number;
+        x?: number;
+        y?: number;
+        zIndex?: number;
+        contain?: boolean;
+    });
+    get information(): {
+        width?: number;
+        height?: number;
+        x?: number;
+        y?: number;
+        zIndex?: number;
+        contain?: boolean;
+    };
+    set information({ width, height, x, y, zIndex, contain, }: {
+        width?: number;
+        height?: number;
+        x?: number;
+        y?: number;
+        zIndex?: number;
+        contain?: boolean;
+    });
+}
+/**
+ * 从服务端来的 widget 数据
+ */
+export declare class WidgetInfo {
+    state: 1 | 0;
+    ownerUserUuid: string;
+    position: {
+        xaxis: number;
+        yaxis: number;
+    };
+    size: {
+        width: number;
+        height: number;
+    };
+    extra: {
+        contain: boolean;
+        zIndex: number;
+        userUuid: string;
+    };
+    constructor({ position, size, extra, ownerUserUuid, state, }: {
+        ownerUserUuid: string;
+        position: {
+            xaxis: number;
+            yaxis: number;
+        };
+        size: {
+            width: number;
+            height: number;
+        };
+        extra: {
+            contain: boolean;
+            zIndex: number;
+            userUuid: string;
+        };
+        state: 1 | 0;
+    });
+    get information(): {
+        state: 0 | 1;
+        ownerUserUuid: string;
+        position: {
+            xaxis: number;
+            yaxis: number;
+        };
+        size: {
+            width: number;
+            height: number;
+        };
+        extra: {
+            contain: boolean;
+            zIndex: number;
+            userUuid: string;
+        };
+    };
+}

package/lib/infra/stores/common/stream-window/type.d.ts

@@ -0,0 +1,32 @@
+export interface StreamWindow {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /**
+     * view 层级关系
+     */
+    zIndex: number;
+    /**
+     * 是否填充到多视频区域
+     */
+    contain: boolean;
+}
+export declare type StreamWindowBounds = Omit<StreamWindow, 'userUuid'>;
+export interface WidgetTrackStruct {
+    state: number;
+    position: {
+        xaxis: number;
+        yaxis: number;
+    };
+    size: {
+        width: number;
+        height: number;
+    };
+    extra: {
+        contain: boolean;
+        zIndex: number;
+        userUuid: string;
+        [key: string]: any;
+    };
+}

package/lib/infra/stores/common/subscription/abstract.d.ts

@@ -0,0 +1,43 @@
+import { AgoraMediaControl, AgoraRteScene, AgoraStream, AGRtcChannel, AGRtcConnectionType, Logger } from 'agora-rte-sdk';
+import { IReactionDisposer } from 'mobx';
+import { Getters } from '../getters';
+import { RemoteStreamMuteStatus } from './type';
+export declare abstract class SceneSubscription {
+    protected scene: AgoraRteScene;
+    protected getters: Getters;
+    logger: Logger;
+    protected _disposers: IReactionDisposer[];
+    protected _active: boolean;
+    protected _rtcChannel: AGRtcChannel;
+    protected _mediaControl: AgoraMediaControl;
+    protected _muteRegistry: Map<string, {
+        muteVideo: boolean;
+        muteAudio: boolean;
+    }>;
+    get active(): boolean;
+    get subscribeAll(): boolean;
+    constructor(scene: AgoraRteScene, getters: Getters);
+    protected abstract handleLocalStreamAdded(streams: AgoraStream[]): void;
+    protected abstract handleLocalStreamUpdated(streams: AgoraStream[]): void;
+    protected abstract handleLocalStreamRemoved(streams: AgoraStream[]): void;
+    protected abstract handleRemoteStreamAdded(streams: AgoraStream[]): void;
+    protected abstract handleRemoteStreamUpdated(streams: AgoraStream[]): void;
+    protected abstract handleRemoteStreamRemoved(streams: AgoraStream[]): void;
+    setActive(active: boolean): void;
+    destroy(): void;
+    printStat(): void;
+    private _handleUserRemoved;
+    protected putRegistry(streamUuid: string, { muteVideo, muteAudio }: {
+        muteVideo?: boolean;
+        muteAudio?: boolean;
+    }): void;
+    protected removeRegistry(streamUuid: string): void;
+    protected isMuted(stream: AgoraStream): {
+        muteVideo: boolean;
+        muteAudio: boolean;
+    };
+    protected muteRemoteStream(scene: AgoraRteScene, stream: AgoraStream, muteStatus: RemoteStreamMuteStatus): RemoteStreamMuteStatus;
+    protected getStreamConnType(stream: AgoraStream): AGRtcConnectionType;
+    protected muteLocalStream(scene: AgoraRteScene, stream: AgoraStream): void;
+    protected muteRemoteStreams(scene: AgoraRteScene, streams: AgoraStream[]): void;
+}

package/lib/infra/stores/common/subscription/index.d.ts

@@ -0,0 +1,14 @@
+import { AgoraRteScene } from 'agora-rte-sdk';
+import { SceneSubscription } from './abstract';
+import { EduUIStoreBase } from '../base';
+export declare class SubscriptionUIStore extends EduUIStoreBase {
+    private _disposers;
+    private _sceneSubscriptions;
+    setActive(sceneId: string): void;
+    createSceneSubscription(scene: AgoraRteScene): SceneSubscription | undefined;
+    removeSceneSubscription(scene: AgoraRteScene): void;
+    clearSubscription(): void;
+    printStat(): void;
+    onInstall(): void;
+    onDestroy(): void;
+}

package/lib/infra/stores/common/subscription/main-room.d.ts

@@ -0,0 +1,14 @@
+import { AgoraStream } from 'agora-rte-sdk';
+import { SceneSubscription } from './abstract';
+export declare class MainRoomSubscription extends SceneSubscription {
+    protected handleLocalStreamAdded(streams: AgoraStream[]): void;
+    protected handleLocalStreamUpdated(streams: AgoraStream[]): void;
+    protected handleLocalStreamRemoved(streams: AgoraStream[]): void;
+    protected handleRemoteStreamAdded(streams: AgoraStream[]): void;
+    protected handleRemoteStreamUpdated(streams: AgoraStream[]): void;
+    protected handleRemoteStreamRemoved(streams: AgoraStream[]): void;
+    get active(): boolean;
+    setActive(active: boolean): void;
+    protected unsubscribeAll(): void;
+    protected subscribe(): void;
+}

package/lib/infra/stores/common/subscription/type.d.ts

@@ -0,0 +1,10 @@
+import { AgoraRteVideoSourceType, AGRtcConnectionType } from 'agora-rte-sdk';
+export declare type RemoteStreamMuteStatus = {
+    muteVideo?: boolean;
+    muteAudio?: boolean;
+};
+export declare type LocalVideoStreamSubscribeOption = {
+    mute: boolean;
+    connectionType: AGRtcConnectionType;
+    sourceType: AgoraRteVideoSourceType;
+};

package/lib/infra/stores/common/toolbar/index.d.ts

@@ -0,0 +1,145 @@
+import { EduUIStoreBase } from '../base';
+import { EduStreamUI } from '../stream/struct';
+import { CabinetItem, ToolbarItem } from './type';
+export declare class ToolbarUIStore extends EduUIStoreBase {
+    readonly defaultColors: string[];
+    readonly defaultPens: string[];
+    readonly paletteMap: Record<string, string>;
+    readonly module: string;
+    readonly allowedCabinetItems: string[];
+    private _disposers;
+    onInstall(): void;
+    activeMap: Record<string, boolean>;
+    private _activeCabinetItems;
+    /**
+     * 当前激活的工具
+     * @returns
+     */
+    get activeTool(): "circle" | "line" | "text" | "square" | "triangle" | "arrow" | "pentagram" | "rhombus" | "pen" | "eraser" | "clicker" | "selection" | "hand" | undefined;
+    /**
+     * 当前激活的画笔类工具
+     * @returns
+     */
+    get selectedPenTool(): "circle" | "line" | "text" | "square" | "triangle" | "arrow" | "pentagram" | "rhombus" | "pen" | "eraser" | "clicker" | "selection" | "hand" | undefined;
+    /**
+     * 画笔工具是否激活
+     * @returns
+     */
+    get isPenToolActive(): boolean | undefined;
+    /**
+     * 选中的画笔颜色
+     * @returns
+     */
+    get currentColor(): string;
+    /**
+     * 选中的画笔粗细
+     * @returns
+     */
+    get strokeWidth(): number;
+    /**
+     * 是否正在进行屏幕共享
+     * @returns
+     */
+    get isScreenSharing(): boolean;
+    /**
+     * 是否打开白板
+     * @returns
+     */
+    get isWhiteboardOpening(): boolean;
+    handleBoradCleaner(id: string): void;
+    /**
+     * 老师流信息列表
+     * @returns
+     */
+    get teacherStreams(): Set<EduStreamUI>;
+    /**
+     * 老师流信息（教室内只有一个老师时使用，如果有一个以上老师请使用 teacherStreams）
+     * @returns
+     */
+    get teacherCameraStream(): EduStreamUI | undefined;
+    startLocalScreenShare(): void;
+    selectScreenShareDevice(): Promise<void>;
+    /**
+     * 打开内建工具
+     * @param id
+     */
+    openBuiltinCabinet(id: string): Promise<void>;
+    handleSliceItem(id: string): void;
+    /**
+     * 选中工具
+     * @param tool
+     * @returns
+     */
+    setTool(tool: string): void;
+    private _openCloudDrive;
+    private _openRoster;
+    private _saveBoardSnapshot;
+    private _setToolActive;
+    private _setToolInactive;
+    readonly penTools: string[];
+    /**
+     * 设置画笔粗细
+     * @param value
+     * @returns
+     */
+    changeStroke(value: number): void;
+    /**
+     * 设置画笔颜色，支持 RGB 色值
+     * @param value
+     * @returns
+     */
+    changeHexColor(value: string): void;
+    /**
+     * 当前激活的工具
+     * @returns
+     */
+    get activeCabinetItems(): Set<string>;
+    /**
+     * 工具箱列表
+     * @returns
+     */
+    get cabinetItems(): CabinetItem[];
+    /**
+     * 白板清除选项列表
+     * @returns
+     */
+    get boardCleanerItems(): CabinetItem[];
+    /**
+     * 工具栏工具列表
+     * @returns
+     */
+    get tools(): ToolbarItem[];
+    /**
+     * 截图选项列表
+     * @returns
+     */
+    get sliceItems(): CabinetItem[];
+    /**
+     * 老师工具栏工具列表
+     * @returns
+     */
+    get teacherTools(): ToolbarItem[];
+    /**
+     * 学生工具栏工具列表
+     * @returns
+     */
+    get studentTools(): ToolbarItem[];
+    /**
+     * 转 Edu 工具 对象
+     * @param tool
+     * @returns
+     */
+    private _convertUITools2EduTools;
+    /**
+     * 转 UI 工具对象
+     * @param tool
+     * @returns
+     */
+    private _convertEduTools2UITools;
+    /**
+     * 把截图贴到白板中
+     * @param dataURL
+     */
+    private _pastToBoard;
+    onDestroy(): void;
+}

package/lib/infra/stores/common/toolbar/type.d.ts

@@ -0,0 +1,45 @@
+export declare enum ToolbarItemCategory {
+    PenPicker = 0,
+    ColorPicker = 1,
+    Cabinet = 2,
+    Eraser = 3,
+    Slice = 4,
+    Roster = 5,
+    Text = 6,
+    Clicker = 7,
+    Selector = 8,
+    CloudStorage = 9,
+    Save = 10,
+    Hand = 11
+}
+export declare enum CabinetItemEnum {
+    ScreenShare = "screenShare",
+    BreakoutRoom = "breakoutRoom",
+    Laser = "laser",
+    Whiteboard = "whiteboard",
+    VideoGallery = "videoGallery"
+}
+export interface CabinetItem {
+    id: string;
+    name: string;
+    iconType?: string;
+}
+export declare class ToolbarItem {
+    static fromData(data: {
+        value: string;
+        label: string;
+        icon: string;
+        category: ToolbarItemCategory;
+        className?: string;
+    }): ToolbarItem;
+    value: string;
+    label: string;
+    icon: string;
+    category: ToolbarItemCategory;
+    className?: string;
+    constructor(icon: string, value: string, label: string, category: ToolbarItemCategory, className?: string);
+}
+export declare enum ScreenShareRoleType {
+    Teacher = "teacher",
+    Student = "student"
+}

package/lib/infra/stores/common/type.d.ts

@@ -0,0 +1,10 @@
+export declare enum OrientationEnum {
+    portrait = "portrait",
+    landscape = "landscape"
+}
+export declare type ConfirmDialogAction = 'ok' | 'cancel';
+export declare enum LayoutMaskCode {
+    None = 0,
+    StageVisible = 1,
+    VideoGalleryVisible = 2
+}

package/lib/infra/stores/common/video-gallery/index.d.ts

@@ -0,0 +1,42 @@
+import { EduUIStoreBase } from '../base';
+import { EduStreamUI } from '../stream/struct';
+export declare class VideoGalleryUIStore extends EduUIStoreBase {
+    private _disposers;
+    private _dialogId?;
+    readonly videoGalleryConfig: {
+        '2x2': number;
+        '3x3': number;
+        '4x4': number;
+    };
+    curPage: number;
+    pageSize: number;
+    loading: boolean;
+    open: boolean;
+    externalOpen: boolean;
+    localPreview: boolean;
+    get localCameraStream(): EduStreamUI | null;
+    get isLocalRendered(): boolean;
+    get stageUserUuids(): string[];
+    get videoGalleryConfigOptions(): {
+        text: string;
+        value: number;
+    }[];
+    get allVideoUserList(): string[];
+    get totalPageNum(): number;
+    get curVideoUserList(): string[];
+    get curStreamList(): EduStreamUI[];
+    nextPage(): void;
+    prevPage(): void;
+    setPageSize(pageSize: number): void;
+    setOpen(open: boolean, id?: string): void;
+    private _updateUsers;
+    openExternalWindow(): void;
+    closeExternalWindow(): void;
+    private _setLoading;
+    private _setCurPage;
+    private _setLocalPreview;
+    private _rtcRawDataCallback;
+    private _sendVideoGalleryState;
+    onInstall(): void;
+    onDestroy(): void;
+}