# Player (/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ```ts export declare interface Player extends Displayer ``` ## 成员 [#成员] - [roomUUID](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#roomuuid) - [slice](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#slice) - [isPlayable](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#isplayable) - [phase](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#phase) - [state](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#state) - [progressTime](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#progresstime) - [timeDuration](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#timeduration) - [framesCount](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#framescount) - [beginTimestamp](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#begintimestamp) - [playbackSpeed](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#playbackspeed) - [play](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#play) - [pause](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#pause) - [stop](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#stop) - [seekToProgressTime](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#seektoprogresstime) - [setObserverMode](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#setobservermode) ## 继承自 Displayer [#继承自-displayer] ## Properties [#properties] ### roomUUID [#roomuuid] readonly roomUUID: string; ```text 录像所属的房间 UUID ``` ### slice [#slice] readonly slice: string; ```text 当前录像所属的分片唯一识别符 ``` ### isPlayable [#isplayable] readonly isPlayable: boolean; ```text 当前是否能立即播放(可能会缓冲) ``` ### phase [#phase] readonly phase: PlayerPhase; ```text 回放播放器连接的阶段 ``` ### state [#state] readonly state: PlayerState; ```text 业务状态 阅读 [《房间与回放的业务状态管理》](/javascript-zh/home/business-state-management) 、[《房间业务状态管理》](/document-zh/home/business-state-management) 以了解更多。 ``` ### progressTime [#progresstime] readonly progressTime: number; ```text 播放进度(毫秒),录像开始时为 0 ``` ### timeDuration [#timeduration] readonly timeDuration: number; ```text 录像时长(毫秒) ``` ### framesCount [#framescount] readonly framesCount: number; ```text 录像总帧数 ``` ### beginTimestamp [#begintimestamp] readonly beginTimestamp: number; ```text 录像开始的绝对时间戳(unix 时间,毫秒) ``` ### playbackSpeed [#playbackspeed] playbackSpeed: number; ```text 播放速度倍率,取 1.0 表明正常速度播放 ``` ### callbacks [#callbacks] readonly callbacks: Callbacks<CALLBACKS>; ### observerId [#observerid] readonly observerId: number; ### region [#region] readonly region: string; ### version [#version] readonly version: string; ### deviceType [#devicetype] readonly deviceType: DeviceType; ### screenType [#screentype] readonly screenType: ScreenType; ### enableWriteNow [#enablewritenow] readonly enableWriteNow: boolean; ### handToolKey [#handtoolkey] readonly handToolKey: string | undefined; ### views [#views] readonly views: Views; ### useMobXState [#usemobxstate] readonly useMobXState: boolean; ### useMultiViews [#usemultiviews] readonly useMultiViews: boolean; ### handToolActive [#handtoolactive] handToolActive: boolean; ### disableOthersSelectingBox [#disableothersselectingbox] disableOthersSelectingBox: boolean; ### disableCameraTransform [#disablecameratransform] disableCameraTransform: boolean; ### commandWheelToZoom [#commandwheeltozoom] commandWheelToZoom: boolean; ## Methods [#methods] ### play [#play] play(): void; ```text 播放 ``` void ### pause [#pause] pause(): void; ```text 暂停 ``` void ### stop [#stop] stop(): void; ```text 停止 ``` void ### seekToProgressTime [#seektoprogresstime] seekToProgressTime(progressTime: number): Promise<PlayerSeekingResult>; ```text 跳转到特定进度 ``` Promise<PlayerSeekingResult> ### setObserverMode [#setobservermode] setObserverMode(observerMode: ObserverMode): void; ```text 修改观察模式 ``` void ### refreshViewSize [#refreshviewsize] refreshViewSize(): void; void ### setCameraBound [#setcamerabound] setCameraBound(cameraBound: CameraBound): void; void ### createScenesCallback [#createscenescallback] createScenesCallback(path: string, callbacks?: Partial<ScenesCallbacks>): ScenesCallbacksNode | null; ScenesCallbacksNode | null ### memberState [#memberstate] memberState(memberId: number): MemberState; MemberState ### moveCamera [#movecamera] moveCamera(camera: Partial<Camera> & Readonly<\{ animationMode?: AnimationMode; \}>): void; void ### moveCameraToContain [#movecameratocontain] moveCameraToContain(rectangle: Rectangle & Readonly<\{ animationMode?: AnimationMode; \}>): void; void ### bindHtmlElement [#bindhtmlelement] bindHtmlElement(element: HTMLDivElement | null): void; void ### getInvisiblePlugin [#getinvisibleplugin] getInvisiblePlugin<A extends Object, MA extends Object>(kind: string): InvisiblePlugin<A, MA> | null; InvisiblePlugin<A, MA> | null ### convertToPointInWorld [#converttopointinworld] convertToPointInWorld(point: \{ x: number; y: number; \}): \{ x: number; y: number; \}; \{ x: number; y: number; \} ### scenePreview [#scenepreview] scenePreview(scenePath: string, div: HTMLElement, width?: number, height?: number, engine?: RenderEngine): void; void ### generateScreenshot [#generatescreenshot] generateScreenshot(scenePath?: string, width?: number, height?: number): Promise<string>; Promise<string> ### fillSceneSnapshot [#fillscenesnapshot] fillSceneSnapshot(scenePath: string, div: HTMLElement, width?: number, height?: number, engine?: RenderEngine): void; void ### screenshotToCanvas [#screenshottocanvas] screenshotToCanvas(context: CanvasRenderingContext2D, scenePath: string, width: number, height: number, camera: Camera, ratio?: number): void; void ### screenshotToCanvasAsync [#screenshottocanvasasync] screenshotToCanvasAsync(context: CanvasRenderingContext2D, scenePath: string, width: number, height: number, camera: Camera, ratio?: number, timeout?: number): Promise<void>; Promise<void> ### getBoundingRect [#getboundingrect] getBoundingRect(scenePath: string): Rectangle; Rectangle ### addMagixEventListener [#addmagixeventlistener] addMagixEventListener(event: string, listener: EventListener, options?: MagixEventListenerOptions): void; addMagixEventListener(event: string, listener: EventsListener, fireInterval: number): void; void void ### removeMagixEventListener [#removemagixeventlistener] removeMagixEventListener(event: string, listener?: EventListener): void; void ### waitMagixEvent [#waitmagixevent] waitMagixEvent(filter: EventFilter): Promise<Event>; Promise<Event> ### scalePptToFit [#scaleppttofit] scalePptToFit(animationMode?: AnimationMode): void; void ### scenePathType [#scenepathtype] scenePathType(path: string): ScenePathType; ScenePathType ### entireScenes [#entirescenes] entireScenes(): SceneMap; SceneMap ### getScene [#getscene] getScene(path: string): WhiteScene | undefined; WhiteScene | undefined