educast-classroom-sdk 2.4.1 → 2.4.3

package/lib/infra/protocol/index.d.ts

@@ -0,0 +1,24 @@
+import { AgoraWidgetController } from 'agora-edu-core';
+import { Logger } from 'agora-rte-sdk';
+import { CabinetItem } from '../stores/common/toolbar/type';
+import { FcrBoardH5WindowConfig, FcrBoardMaterialWindowConfig, FcrBoardMediaWindowConfig, OrientationStates, StreamMediaPlayerOpenParams, WebviewOpenParams } from './type';
+import { MobileCallState } from '../stores/lecture-mobile/layout';
+export declare class Extension {
+    logger: Logger;
+    private _controller?;
+    private _registeredCabinetItems;
+    get cabinetItems(): CabinetItem[];
+    install(controller: AgoraWidgetController): void;
+    uninstall(): void;
+    private _handleRegisterCabinetTool;
+    private _handleUnregisterCabinetTool;
+    openWebview(params: WebviewOpenParams): void;
+    openMediaStreamPlayer(params: StreamMediaPlayerOpenParams): void;
+    openMaterialResourceWindow(resource: FcrBoardMaterialWindowConfig): void;
+    openMediaResourceWindow(resource: FcrBoardMediaWindowConfig): void;
+    openH5ResourceWindow(resource: FcrBoardH5WindowConfig): void;
+    updateOrientationStates(param: OrientationStates): void;
+    updateMobileLandscapeToolBarVisible(visible: boolean): void;
+    updateMobileCallState(callState: MobileCallState): void;
+    private _broadcastMessage;
+}

package/lib/infra/protocol/type.d.ts

@@ -0,0 +1,70 @@
+import { OrientationEnum } from '../stores/common/type';
+export declare enum BoardConnectionState {
+    Disconnected = 0,
+    Connecting = 1,
+    Connected = 2,
+    Reconnecting = 3,
+    Disconnecting = 4
+}
+export declare enum BoardMountState {
+    NotMounted = 0,
+    Mounted = 1
+}
+/** Board types */
+export declare enum FcrBoardTool {
+    Selector = 1,
+    LaserPointer = 2,
+    Eraser = 3,
+    Clicker = 4,
+    Hand = 5,
+    Text = 6
+}
+export declare enum FcrBoardShape {
+    Curve = 1,
+    Straight = 2,
+    Arrow = 3,
+    Rectangle = 4,
+    Triangle = 5,
+    Rhombus = 6,
+    Pentagram = 7,
+    Ellipse = 8
+}
+export declare type WebviewOpenParams = {
+    resourceUuid: string;
+    url: string;
+    title: string;
+};
+export declare type StreamMediaPlayerOpenParams = {
+    resourceUuid: string;
+    url: string;
+    title: string;
+};
+export declare type Color = {
+    r: number;
+    g: number;
+    b: number;
+    a?: number;
+};
+export declare type FcrBoardMaterialWindowConfig<T = unknown> = {
+    resourceUuid: string;
+    urlPrefix: string;
+    title: string;
+    pageList: T[];
+    taskUuid: string;
+    resourceHasAnimation: boolean;
+};
+export declare type FcrBoardMediaWindowConfig = {
+    resourceUuid: string;
+    resourceUrl: string;
+    title: string;
+    mimeType: string;
+};
+export declare type FcrBoardH5WindowConfig = {
+    resourceUuid: string;
+    resourceUrl: string;
+    title: string;
+};
+export declare type OrientationStates = {
+    orientation: OrientationEnum;
+    forceLandscape: boolean;
+};

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

@@ -0,0 +1,46 @@
+import { EduClassroomStore } from 'agora-edu-core';
+import { EduShareUIStore } from './share';
+import { Board } from '@classroom/infra/protocol/board';
+import { Extension } from '@classroom/infra/protocol';
+import { Getters } from './getters';
+import { Logger } from 'agora-rte-sdk';
+export declare abstract class EduUIStoreBase {
+    private static _boardApi;
+    private static _extensionApi;
+    protected readonly logger: Logger;
+    /**
+     * 参数覆盖
+     */
+    protected get uiOverrides(): {};
+    protected readonly getters: Getters;
+    /**
+     * 当前 EduClassroomStore 实例
+     */
+    readonly classroomStore: EduClassroomStore;
+    /**
+     * EduShareUIStore 实例
+     */
+    readonly shareUIStore: EduShareUIStore;
+    /**
+     * 构造函数
+     * @param store
+     * @param shareUIStore
+     */
+    constructor(store: EduClassroomStore, shareUIStore: EduShareUIStore, getters: Getters);
+    /**
+     * 初始化
+     */
+    abstract onInstall(): void;
+    /**
+     * 销毁
+     */
+    abstract onDestroy(): void;
+    /**
+     * 白板API服务
+     */
+    get boardApi(): Board;
+    /**
+     * 扩展API
+     */
+    get extensionApi(): Extension;
+}

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

@@ -0,0 +1,41 @@
+/// <reference types="react" />
+import { IReactionDisposer, Lambda } from 'mobx';
+import { EduUIStoreBase } from '../base';
+export declare class BoardUIStore extends EduUIStoreBase {
+    protected _disposers: (IReactionDisposer | Lambda)[];
+    protected get uiOverrides(): {
+        heightRatio: number;
+    };
+    /**
+     * 白板容器高度
+     * @returns
+     */
+    get boardAreaHeight(): number;
+    isCopying: boolean;
+    get isTeacherOrAssistant(): boolean;
+    get grantedUsers(): Set<string>;
+    get isGrantedBoard(): boolean;
+    get undoSteps(): number;
+    get redoSteps(): number;
+    get currentSceneIndex(): number;
+    get scenesCount(): number;
+    get mounted(): boolean;
+    onInstall(): void;
+    private _handleUIEvents;
+    addMainViewScene(): void;
+    toPreMainViewScene(): void;
+    toNextMainViewScene(): void;
+    setDelay(delay: number): void;
+    /**
+     * for teacher and assistent only
+     *
+     * @param event
+     */
+    handleDragOver(event: React.DragEvent<HTMLDivElement>): void;
+    /**
+     * for teacher and assistent only
+     * @param event
+     */
+    hanldeDrop(event: React.DragEvent<HTMLDivElement>): Promise<void>;
+    onDestroy(): void;
+}

package/lib/infra/stores/common/cloud-drive/helper.d.ts

@@ -0,0 +1,14 @@
+import { CourseWareItem } from '@classroom/infra/api';
+import { CloudDriveResource, ConversionOption } from 'agora-edu-core';
+export declare const h5Type = "ah5";
+export declare const linkType = "alf";
+export declare const imageTypes: string[];
+export declare const mediaVideoTypes: string[];
+export declare const mediaAudioTypes: string[];
+export declare const convertableTypes: string[];
+export declare const convertableDynamicTypes: string[];
+export declare const supportedTypes: string[];
+export declare const createCloudResource: (data: CourseWareItem) => CloudDriveResource | never;
+export declare const conversionOption: (ext: string, scale?: number | undefined) => ConversionOption | undefined;
+export declare const extractFileExt: (name: string) => string | undefined;
+export declare const fileExt2ContentType: (fileExt: string) => string;

package/lib/infra/stores/common/cloud-drive/index.d.ts

@@ -0,0 +1,178 @@
+import { IUploadOnlineCoursewareData } from '@classroom/infra/capabilities/containers/cloud-driver/person-resource';
+import { CloudDrivePagingOption, CloudDriveResource, CloudDriveResourceUploadStatus } from 'agora-edu-core';
+import { SvgIconEnum } from '@classroom/ui-kit';
+import { EduUIStoreBase } from '../base';
+export declare enum FileTypeSvgColor {
+    ppt = "#F6B081",
+    word = "#96CBE1",
+    excel = "#A6DDBF",
+    pdf = "#A3C3DE",
+    video = "#A8ABE9",
+    audio = "#6C82D1",
+    txt = "#8597FF",
+    image = "#95E2E7"
+}
+export interface UploadItem {
+    resourceUuid: string;
+    iconType?: string;
+    fileName?: string;
+    fileSize?: string;
+    currentProgress?: number;
+    status: CloudDriveResourceUploadStatus;
+}
+export declare class CloudUIStore extends EduUIStoreBase {
+    readonly pageSize: number;
+    personalResourceUuidByPage: Map<number, string[]>;
+    personalResourcesTotalNum: number;
+    private _disposers;
+    private _isUploading;
+    onInstall(): void;
+    /**
+     * 根据类型返回扩展名
+     * @param name
+     * @returns
+     */
+    fileNameToType(name: string): SvgIconEnum.ALF | SvgIconEnum.AUDIO | SvgIconEnum.EXCEL | SvgIconEnum.H5 | SvgIconEnum.IMAGE | SvgIconEnum.PDF | SvgIconEnum.PPT | SvgIconEnum.UNKNOWN | SvgIconEnum.VIDEO | SvgIconEnum.WORD;
+    /**
+     * 文件大小信息格式化
+     * @param fileByteSize
+     * @param decimalPoint
+     * @returns
+     */
+    formatFileSize(fileByteSize: number, decimalPoint?: number): string;
+    /**
+     * 刷新资源列表
+     */
+    reloadPersonalResources(): Promise<void>;
+    /**
+     * 查询个人资源列表
+     * @param options
+     * @returns
+     */
+    fetchPersonalResources(options: CloudDrivePagingOption): Promise<{
+        list: never[];
+        total: number;
+    } | undefined>;
+    /**
+     *
+     * @param files
+     */
+    validateFiles(files: File[]): boolean;
+    /**
+     * 上传文件至个人资源
+     * @param file
+     * @returns
+     */
+    uploadPersonalResource(files: File[]): Promise<void>;
+    addOnlineCourseware({ resourceName, url }: IUploadOnlineCoursewareData): Promise<void>;
+    /**
+     * 打开课件
+     */
+    private _tryOpenCourseware;
+    /**
+     * 打开课件
+     * @param resource
+     */
+    openResource(resource: CloudDriveResource): Promise<void>;
+    /**
+     * 公共资源
+     * @returns
+     */
+    get publicResources(): Map<string, CloudDriveResource>;
+    showUploadModal: boolean;
+    showUploadToast: boolean;
+    /**
+     * 上传状态
+     */
+    uploadState: 'uploading' | 'success' | 'error' | 'idle';
+    /**
+     * 云盘上传modal最小化显示
+     */
+    showUploadMinimize: boolean;
+    /**
+     * 检索公共资源课件字符串
+     */
+    searchPublicResourcesKeyword: string;
+    /**
+     * 检索个人资源课件字符串
+     */
+    searchPersonalResourcesKeyword: string;
+    /**
+     * 个人资源左侧选项框状态
+     */
+    personalResourcesCheckSet: Set<string>;
+    /**
+     * 个人资源页码
+     */
+    currentPersonalResPage: number;
+    /**
+     * 个人资源全选
+     */
+    isPersonalResSelectedAll: boolean;
+    /**
+     * 云盘资源列表
+     */
+    get personalResources(): Map<string, CloudDriveResource>;
+    /**
+     * 云盘资源列表（左侧选择框使用）
+     * @returns
+     */
+    get personalResourcesList(): {
+        resource: CloudDriveResource;
+        checked: boolean;
+    }[];
+    /**
+     * 是否有选中资源文件
+     * @returns
+     */
+    get hasSelectedPersonalRes(): boolean;
+    /**
+     * 资源上传进度
+     * @returns
+     */
+    get uploadingProgresses(): UploadItem[];
+    /**
+     * 勾选资源文件
+     * @param resourceUuid
+     * @param val
+     */
+    setPersonalResourceSelected: (resourceUuid: string, val: boolean) => void;
+    /**
+     * 资源列表全选
+     * @param val
+     */
+    setAllPersonalResourceSelected: (val: boolean) => void;
+    /**
+     * 设置资源列表页码
+     * @param num
+     */
+    setPersonalResCurrentPage: (num: number) => void;
+    /**
+     * 设置上传状态
+     * @param uploadState
+     */
+    setUploadState: (uploadState: 'uploading' | 'success' | 'error') => void;
+    setShowUploadModal: (v: boolean) => void;
+    setShowUploadToast: (v: boolean) => void;
+    /**
+     * 设置云盘上传modal最小化
+     * @param v
+     */
+    setShowUploadMinimize: (v: boolean) => void;
+    /**
+     * 删除个人资源
+     * @returns
+     */
+    removePersonalResources: (singleFileUuid?: string | undefined) => Promise<void>;
+    /**
+     * 设置检索公共资源字符串
+     * @param keyword
+     */
+    setSearchPublicResourcesKeyword(keyword: string): void;
+    /**
+     * 设置检索个人资源字符串
+     * @param keyword
+     */
+    setSearchPersonalResourcesKeyword(keyword: string): void;
+    onDestroy(): void;
+}

package/lib/infra/stores/common/cloud-drive/struct.d.ts

@@ -0,0 +1,109 @@
+/**
+ * 云盘资源对象。支持两种类型；
+ * - `'dynamic'`: 动态资源
+ * - `'static'`: 静态资源
+ */
+import { CloudDriveResource, ConversionOption } from 'agora-edu-core';
+import { CloudDriveResourceConvertProgress } from './type';
+/** @en
+ * The cloud drive resource object. Supports two types of resources:
+ * - `'dynamic'`: Dynamic resources.
+ * - `'static'`: Static resources.
+ */
+export declare class CloudDriveCourseResource extends CloudDriveResource {
+    private _taskProgress;
+    taskUuid: string;
+    conversion: ConversionOption;
+    scenes: {
+        name?: string;
+        previewUrl?: string;
+        contentUrl: string;
+        height: number;
+        width: number;
+    }[];
+    constructor(data: {
+        ext: string;
+        resourceName: string;
+        resourceUuid: string;
+        size: number;
+        updateTime: number;
+        taskProgress: CloudDriveResourceConvertProgress;
+        taskUuid: string;
+        conversion: ConversionOption;
+        initOpen?: boolean;
+    });
+    get hasAnimation(): boolean;
+    get convertedPercentage(): number;
+    get status(): "Waiting" | "Converting" | "Finished" | "Fail";
+    get prefix(): string | undefined;
+}
+/**
+ * 多媒体资源文件对象。支持以下类型：
+ * - `'video'`: 视频文件
+ * - `'audio'`: 音频文件
+ */
+/** @en
+ * The multi-media resource object. Supports types of multi-media resources:
+ * - `'video'`
+ * - `'audio'`
+ */
+export declare class CloudDriveMediaResource extends CloudDriveResource {
+    url: string;
+    type: 'video' | 'audio';
+    constructor(data: {
+        ext: string;
+        resourceName: string;
+        resourceUuid: string;
+        size: number;
+        updateTime: number;
+        url: string;
+        type: 'video' | 'audio';
+        initOpen?: boolean;
+    });
+}
+/**
+ * 图片资源文件对象
+ */
+/** @en
+ * Cloud Drive Image Resource
+ */
+export declare class CloudDriveImageResource extends CloudDriveResource {
+    url: string;
+    constructor(data: {
+        ext: string;
+        resourceName: string;
+        resourceUuid: string;
+        size: number;
+        updateTime: number;
+        url: string;
+        initOpen?: boolean;
+    });
+}
+export declare class CloudDriveH5Resource extends CloudDriveResource {
+    url: string;
+    type: string;
+    constructor(data: {
+        ext: string;
+        resourceName: string;
+        resourceUuid: string;
+        size: number;
+        updateTime: number;
+        url: string;
+        type: string;
+        initOpen?: boolean;
+    });
+}
+export declare class CloudDriveLinkResource extends CloudDriveResource {
+    url: string;
+    type: string;
+    constructor(data: {
+        ext: string;
+        resourceName: string;
+        resourceUuid: string;
+        size: number;
+        updateTime: number;
+        url: string;
+        type: string;
+        initOpen?: boolean;
+    });
+}

package/lib/infra/stores/common/cloud-drive/type.d.ts

@@ -0,0 +1,23 @@
+export interface CloudDriveResourceConvertProgress {
+    prefix?: string;
+    status: 'Waiting' | 'Converting' | 'Finished' | 'Fail';
+    totalPageSize: number;
+    convertedPageSize: number;
+    convertedPercentage: number;
+    convertedFileList: {
+        name?: string;
+        ppt: {
+            preview?: string;
+            src: string;
+            width: number;
+            height: number;
+        };
+    }[];
+    currentStep: string;
+    previews: Record<number, string>;
+    images: Record<number, {
+        width: number;
+        height: number;
+        url: string;
+    }>;
+}

package/lib/infra/stores/common/device-setting/index.d.ts

@@ -0,0 +1,68 @@
+import { EduUIStoreBase } from '../base';
+import { ClassroomState } from 'agora-edu-core';
+export declare type SettingToast = {
+    id: string;
+    type: 'video' | 'audio_recording' | 'audio_playback' | 'error';
+    info: string;
+};
+export declare class DeviceSettingUIStore extends EduUIStoreBase {
+    private _defaultSystemAudioRecordingDeviceId?;
+    private _defaultSystemAudioPlaybackDeviceId?;
+    private _userHasSelectedAudioRecordingDevice;
+    private _userHasSelectedAudioPlaybackDevice;
+    private _disposers;
+    onInstall(): void;
+    /**
+     * 获取视频设备信息
+     **/
+    /** @en
+     * get camera accessors
+     */
+    get cameraAccessors(): {
+        classroomState: ClassroomState;
+        cameraDeviceId: string | undefined;
+        localCameraStreamUuid: string | undefined;
+    };
+    /**
+     * 音频设备信息
+     **/
+    /** @en
+     * mic Accessors
+     */
+    get micAccessors(): {
+        classroomState: ClassroomState;
+        recordingDeviceId: string | undefined;
+        localMicStreamUuid: string | undefined;
+    };
+    /**
+     * 是否可设置隐藏/显示讲台区域
+     */
+    get deviceStage(): boolean | undefined;
+    get stageVisible(): boolean;
+    /**
+     * 设置当前使用摄像头设备
+     * @param id
+     */
+    setCameraDevice(id: string): void;
+    /**
+     * 设置当前使用麦克风设备
+     * @param id
+     */
+    setRecordingDevice(id: string): void;
+    /**
+     * 设置当前使用扬声器设备
+     * @param id
+     */
+    setPlaybackDevice(id: string): void;
+    setUserHasSelectedAudioRecordingDevice(): void;
+    setUserHasSelectedAudioPlaybackDevice(): void;
+    /**
+     * 设置讲台开关
+     * 停止轮询 业务逻辑
+     * @param stage
+     */
+    setStageVisible(stage: boolean): Promise<void>;
+    private _enableLocalVideo;
+    private _enableLocalAudio;
+    onDestroy(): void;
+}

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

@@ -0,0 +1,61 @@
+import { EduStream } from 'agora-edu-core';
+import { EduClassroomUIStore } from '.';
+export declare class Getters {
+    private _classroomUIStore;
+    constructor(_classroomUIStore: EduClassroomUIStore);
+    get classroomUIStore(): EduClassroomUIStore;
+    /**
+     * 讲台
+     */
+    get layoutMaskCode(): number;
+    /**
+     * 讲台是否显示
+     */
+    get stageVisible(): boolean;
+    /**
+     * 扩展屏是否已开启
+     */
+    get videoGalleryStarted(): boolean;
+    /**
+     * 分组讨论是否已开启
+     */
+    get breakoutRoomStarted(): boolean;
+    /**
+     * 小窗用户ID
+     */
+    get windowStreamUserUuids(): (string | undefined)[];
+    /**
+     * 扩展屏流ID
+     */
+    get galleryVideoStreamUuids(): string[];
+    /**
+     * 台上用户ID
+     */
+    get stageUserUuids(): string[];
+    /**
+     * 老师流信息
+     * @returns
+     */
+    get teacherCameraStream(): EduStream;
+    /**
+     * 学生流信息列表
+     * @returns
+     */
+    get studentCameraStreams(): EduStream[];
+    /**
+     * 台上人员流列表
+     */
+    get stageCameraStreams(): EduStream[];
+    /**
+     * 是否在分组房间
+     */
+    get isInSubRoom(): boolean;
+    /**
+     * 本地摄像头视频流
+     */
+    get localCameraStream(): EduStream | undefined;
+    /**
+     * 本地屏幕视频流
+     */
+    get localScreenStream(): EduStream | undefined;
+}