Agora Interactive Whiteboard Web SDK API Reference
- Web
更新时间不可用
视角状态,包含视角为主播模式的用户信息。
Enumerations
- AnimationMode
- ApplianceNames
- AsyncModuleLoadMode
- ConversionType
- CurrentStep
- CursorNames
- DeviceType
- EventPhase
- EventScope
- KeyboardKind
- LoggerReportMode
- LowTaskAnimationInterval
- NewPencilWritingQuality
- ObserverMode
- OriginCoordType
- PlayerPhase
- PlayerSeekingResult
- RenderEngine
- RoomErrorLevel
- RoomPhase
- ScenePathType
- Scope
- ScreenType
- ShapeType
- Status
- ViewMode
Classes
Interfaces
- Callbacks
- Cursor
- CursorAdapter
- CursorMember
- Displayer
- OptimizeOptions
- Player
- PluginInstance
- Plugins
- Room
- ScenesCallbacksNode
Type aliases
BroadcastState
BroadcastState: {broadcasterId?:number;mode:ViewMode}- Defined in index-zh.d.ts:2948
Type declaration
| 参数名 | 描述 |
|---|---|
broadcasterIdnumber | 主播模式用户的用户 ID。若没有主播模式的用户,则为 |
modeViewMode | 用户的视角模式。 |
Camera
Camera: {centerX:number;centerY:number;scale:number}- Defined in index-zh.d.ts:166
视角的描述。
Type declaration
| 参数名 | 描述 |
|---|---|
centerXnumber | 视角的中心点在世界坐标系(以白板初始化时的中心点为原点的坐标系)中的 X 轴坐标。 |
centerYnumber | 视角的中心点在世界坐标系(以白板初始化时的中心点为原点的坐标系)中的 Y 轴坐标。 |
scalenumber | 视角的缩放比例。 |
CameraBound
CameraBound: {centerX?:number;centerY?:number;damping?:number;height?:number;maxContentMode?:ContentMode;minContentMode?:ContentMode;width?:number}- Defined in index-zh.d.ts:1437
CameraBound 类型用于设置视角边界。
视角边界是白板上用户可以看见的部分。在视角边界内,用户可以自由移动和缩放视角。视角如果超出了视角边界的范围,会被 SDK 拉回视角边界内。
Type declaration
| 参数名 | 描述 |
|---|---|
centerXnumber | 视角边界的中心点在世界坐标系(以白板初始化时的中心点为原点的坐标系)中的 X 轴坐标,默认值是 0.0。 |
centerYnumber | 视角边界的中心点在世界坐标系(以白板初始化时的中心点为原点的坐标系)中的 Y 轴坐标,默认值是 0.0。 |
dampingnumber | 用户将视角移出视角边界时感受到的阻力大小。取值范围为 [0.0,1.0],默认值为 0.75。取值越大,用户感受到的阻力越大。
|
heightnumber | 视角边界的高度,单位为像素。默认值是 |
maxContentModeContentMode | 视角边界的最大缩放比例。如果不填,则表示视角缩放没有上限。 |
minContentModeContentMode | 视角边界的最小缩放比例。如果不填,则表示视角缩放没有下限。 |
widthnumber | 视角边界的宽度,单位为像素。默认值是 |
CameraState
CameraState: Camera&{height:number;width:number}- Defined in index-zh.d.ts:4778
since
Color
Color: number[]- Defined in index-zh.d.ts:3467
颜色,RGB 格式。例如, [0, 0, 255] 代表蓝色。
ConstructRoomParams
ConstructRoomParams: {cameraBound?:CameraBound;commandWheelToZoom?:boolean;cursorAdapter?:CursorAdapter|false;disableAutoResize?:boolean;disableCameraTransform?:boolean;disableOthersSelectingBox?:boolean;invisiblePlugins?:ReadonlyArray<InvisiblePluginClass<string,any,any>>;wrappedComponents?:WrappedComponents}- Defined in index-zh.d.ts:3902
Type declaration
| 参数名 | 描述 |
|---|---|
cameraBoundCameraBound | 设置视角边界,即用户可以自由移动视角的范围。默认值为 |
commandWheelToZoomboolean | 是否允许按住 since 2.16.51
note
|
cursorAdapterCursorAdapter | false | 设置鼠标的光标适配器,详见 《鼠标光标适配器》。
设置为 |
disableAutoResizeboolean | 是否关闭自动适配尺寸功能。
|
disableCameraTransformboolean | 是否禁止用户通过触屏手势或鼠标滚轮移动或缩放调整视角。
该属性不会影响 |
disableOthersSelectingBoxboolean | 是否隐藏其他人的鼠标移动到白板组件上时显示的高亮框。 since 2.12.0
该属性不影响自己的高亮框显示。 |
invisiblePluginsReadonlyArray & lt;InvisiblePluginClass & lt;string,any,any & gt; & gt; | 不可见插件列表。 |
wrappedComponentsWrappedComponents | 由 |
ContentMode
- Defined in index-zh.d.ts:1478
实时缩放比例。
param
屏幕的尺寸。
param
视角边界的尺寸。
returns
根据 screenSize 和 boundSize 计算出来的缩放比例。
Type declaration
| 返回类型 | 描述 |
|---|---|
number |
ConvertedFile
ConvertedFile: {conversionFileUrl:string;height:number;preview?:string;width:number}- Defined in index-zh.d.ts:5090
转换后生成的图片或动态 PPT 页。
Type declaration
| 参数名 | 描述 |
|---|---|
conversionFileUrlstring | 图片的 URL 地址或动态 PPT 页的 URI 地址。 |
heightnumber | 图片或动态 PPT 页在白板中的高度,单位为像素。 |
previewstring | 图片或动态 PPT 预览图的 URL 地址。 |
widthnumber | 图片或动态 PPT 页在白板中的宽度,单位为像素。 |
CursorDescription
CursorDescription: {height:number;width:number;x:number;y:number}- Defined in index-zh.d.ts:508
光标的描述。
Type declaration
| 参数名 | 描述 |
|---|---|
heightnumber | 光标图形的高。 |
widthnumber | 光标图形的宽。 |
xnumber | 光标指示区域中心的 X 轴坐标(以光标图形的左上角为原点)。 |
ynumber | 光标指示区域中心的 Y 轴坐标(以光标图形的左上角为原点)。 |
DisplayerCallbacks
DisplayerCallbacks: {onBackgroundError:(url:string)=>void;onCatchErrorWhenAppendFrame:(userId:number, error:Error)=>void;onCatchErrorWhenRender:(error:Error)=>void;onEnableWriteNowChanged:(enableWriteNow:boolean)=>void;onHandToolActive:(active:boolean)=>void;onPPTMediaPause:(shapeId:string, type:MediaType)=>void;onPPTMediaPlay:(shapeId:string, type:MediaType)=>void;onPPTMediaPlayError:(shapeId:string, type:MediaType, error:Error)=>void;onRenderDuration:(renderDuration:number)=>void;onSliceChanged:(slice:string)=>void}- Defined in index-zh.d.ts:1920
Displayer 对象的回调。
Type declaration
| 参数名 | 描述 | ||||
|---|---|---|---|---|---|
onBackgroundError(url:string)= & gt;void | 加载背景图片失败回调。
Parameters
| ||||
onCatchErrorWhenAppendFrame(userId:number, error:Error)= & gt;void | 同步用户行为发生错误的回调。
Parameters
| ||||
onCatchErrorWhenRender(error:Error)= & gt;void | 渲染发生错误回调。
Parameters
| ||||
onEnableWriteNowChanged(enableWriteNow:boolean)= & gt;void | 用户的可写权限发生改变的回调。 since 2.10.0
Parameters
| ||||
onHandToolActive(active:boolean)= & gt;void | 抓手工具的启用状态发生改变的回调。
Parameters
| ||||
onPPTMediaPause(shapeId:string, type:MediaType)= & gt;void | Parameters
| ||||
onPPTMediaPlay(shapeId:string, type:MediaType)= & gt;void | Parameters
| ||||
onPPTMediaPlayError(shapeId:string, type:MediaType, error:Error)= & gt;void | 动态 PPT 中的媒体文件播放出错回调。
Parameters
| ||||
onRenderDuration(renderDuration:number)= & gt;void | 渲染时长回调。
Parameters
| ||||
onSliceChanged(slice:string)= & gt;void | 所处分片发生改变的回调。
Parameters
|
DisplayerState
DisplayerState: {cameraState:CameraState;globalState:GlobalState;roomMembers:ReadonlyArray<RoomMember>;sceneState:SceneState}- Defined in index-zh.d.ts:1896
DisplayerState 是 Room 对象和 Player 对象共有的类型。
Type declaration
| 参数名 | 描述 |
|---|---|
cameraStateCameraState | 当前视角的状态。 since 2.10.0 |
globalStateGlobalState | 房间的全局状态。详见 GlobalState。 |
roomMembersReadonlyArray & lt;RoomMember & gt; | 房间内所有互动模式(具有读写权限)用户的状态。 |
sceneStateSceneState | 当前场景的状态。 |
Event
Event: {authorId:number;event:string;payload:any;phase:EventPhase;scope:Scope}- Defined in index-zh.d.ts:24
自定义事件。
Type declaration
| 参数名 | 描述 |
|---|---|
authorIdnumber | 事件触发者的用户 ID,若是系统事件,则为 AdminObserverId。 |
eventstring | 自定义事件的名称。 |
payloadany | 自定义事件的内容。 |
phaseEventPhase | 自定义事件的状态。 |
scopeScope | 自定义事件的范围。 |
EventFilter
EventFilter: (event:Event)=>boolean- Defined in index-zh.d.ts:4764
事件过滤器。
Type declaration
(event: Event): boolean| 参数名 | 描述 |
|---|---|
eventEvent |
| 返回类型 | 描述 |
|---|---|
boolean |
EventListener
EventListener: (event:Event)=>void- Defined in index-zh.d.ts:4734
事件监听器。
Type declaration
(event: Event): void| 参数名 | 描述 |
|---|---|
eventEvent |
| 返回类型 | 描述 |
|---|---|
void |
EventsListener
EventsListener: (events:Event[])=>void- Defined in index-zh.d.ts:4759
事件组监听器。
Type declaration
(events: Event[]): void| 参数名 | 描述 |
|---|---|
eventsEvent[] |
| 返回类型 | 描述 |
|---|---|
void |
FloatBarOptions
FloatBarOptions: {colors:ReadonlyArray<Readonly<Color>>}- Defined in index-zh.d.ts:530
悬浮条的配置参数。
Type declaration
| 参数名 | 描述 |
|---|---|
colorsReadonlyArray & lt;Readonly & lt;Color & gt; & gt; | 悬浮条调色盘的颜色列表。 |
GlobalState
GlobalState: {}- Defined in index-zh.d.ts:3475
实时房间的公共全局变量。
房间内所有用户看到的都是相同的 globalState,所有互动模式用户都可以读写。修改 globalState 属性会立即生效并同步给所有用户。
Type declaration
HotKey
HotKey: string|HotKeyDescription|ReadonlyArray<string|HotKeyDescription>|HotKeyChecker- Defined in index-zh.d.ts:1061
自定义快捷键。
HotKeyChecker
HotKeyChecker: (event:HotKeyEvent, kind:KeyboardKind)=>boolean- Defined in index-zh.d.ts:1141
快捷键检查器。
param
自定义快捷键的事件。
param
键盘的类型。
returns
是否为指定的快捷键:
true:是指定的快捷键。false:不是指定的快捷键。
Type declaration
(event: HotKeyEvent, kind: KeyboardKind): boolean| 参数名 | 描述 |
|---|---|
eventHotKeyEvent | |
kindKeyboardKind |
| 返回类型 | 描述 |
|---|---|
boolean |
HotKeyDescription
HotKeyDescription: {altKey:boolean|null;ctrlKey:boolean|null;key:string;shiftKey:boolean|null}- Defined in index-zh.d.ts:1066
自定义快捷键的描述。
Type declaration
| 参数名 | 描述 |
|---|---|
altKeyboolean | null | 是否使用 Alt 键。 |
ctrlKeyboolean | null | 是否使用 Ctrl 键。 C |
keystring | 指定的键。 |
shiftKeyboolean | null | 是否使用 Shift 键。 |
HotKeyEvent
HotKeyEvent: {altKey:boolean;ctrlKey:boolean;key:string;kind:"KeyDown"|"KeyUp";nativeEvent?:KeyboardEvent;shiftKey:boolean}- Defined in index-zh.d.ts:1088
自定义快捷键的事件。
Type declaration
| 参数名 | 描述 |
|---|---|
altKeyboolean | 是否使用 Alt 键。 |
ctrlKeyboolean | 是否使用 Ctrl 键。 |
keystring | 指定的键。 |
kind"KeyDown" | "KeyUp" | 快捷键的事件类型。
|
nativeEventKeyboardEvent | 浏览器的原生事件。 |
shiftKeyboolean | 是否使用 Shift 键。 |
HotKeys
HotKeys: {changeToArrow:HotKey;changeToClick:HotKey;changeToEllipse:HotKey;changeToEraser:HotKey;changeToHand:HotKey;changeToLaserPointer:HotKey;changeToPencil:HotKey;changeToRectangle:HotKey;changeToSelector:HotKey;changeToStraight:HotKey;changeToText:HotKey;copy:HotKey;delete:HotKey;duplicate:HotKey;lock:HotKey;paste:HotKey;redo:HotKey;undo:HotKey}- Defined in index-zh.d.ts:983
快捷键对应的效果。
Type declaration
| 参数名 | 描述 |
|---|---|
changeToArrowHotKey | 切换到箭头工具( |
changeToClickHotKey | 切换到点选工具 ( |
changeToEllipseHotKey | 切换到椭圆工具( |
changeToEraserHotKey | 切换到橡皮工具( |
changeToHandHotKey | 切换到抓手工具( |
changeToLaserPointerHotKey | 切换到激光笔( |
changeToPencilHotKey | 切换到铅笔工具( |
changeToRectangleHotKey | 切换到矩形工具( |
changeToSelectorHotKey | 切换到选择工具( |
changeToStraightHotKey | 切换到直线工具( |
changeToTextHotKey | 切换到文字工具( |
copyHotKey | 复制。 |
deleteHotKey | 删除。 |
duplicateHotKey | 复制并粘贴。 |
lockHotKey | 锁定缩放比例。 |
pasteHotKey | 粘贴。 |
redoHotKey | 重做。 |
undoHotKey | 撤回。 |
Identifier
Identifier: string- Defined in index-zh.d.ts:4428
组件插件的唯一标识符。
ImageInformation
ImageInformation: {centerX:number;centerY:number;crossOrigin?:boolean|string;height:number;locked:boolean;uniformScale?:boolean;uuid:string;width:number}- Defined in index-zh.d.ts:3515
图片的描述。
Type declaration
| 参数名 | 描述 |
|---|---|
centerXnumber | 图片的中心在世界坐标系(以白板初始化时的中心点为原点的坐标系)中的 X 轴坐标。 |
centerYnumber | 图片的中心在世界坐标系(以白板初始化时的中心点为原点的坐标系)中的 Y 轴坐标。 |
crossOriginboolean | string | 是否以跨域方式加载图片。 since 2.16.48
|
heightnumber | 图片的高度,单位为像素。如果图片的高度超出视角的边界,用户将看不到超出部分。 |
lockedboolean | 图片是否被锁定。
|
uniformScaleboolean | 图片是否只能等比放缩。 since 2.12.0
|
uuidstring | 图片的 UUID,即图片在互动白板实时房间中的唯一标识符。 |
widthnumber | 图片的宽度,单位为像素。如果图片的宽度超出视角的边界,用户将看不到超出部分。 |
International
International: {displayNote?:string;displaySidebar?:string;hideNote?:string;hideSidebar?:string;jumpTo?:string;nextPage?:string;nextStep?:string;pageNumber?:string;prePage?:string;preStep?:string;resetCurrentPPTAnimation?:string;resetCurrentSlideAnimation?:string}- Defined in index-zh.d.ts:4894
International 类,用于添加 PPT 预览菜单栏的界面文字。你可以直接传入要展示的文字,例如 “Next”。
Type declaration
| 参数名 | 描述 |
|---|---|
displayNotestring | “显示 PPT 备注”的界面文字。 |
displaySidebarstring | “显示侧边栏”的界面文字。 |
hideNotestring | “隐藏 PPT 备注”的界面文字。 |
hideSidebarstring | “隐藏侧边栏”的界面文字。 |
jumpTostring | “跳转到”的界面文字。 |
nextPagestring | “下一页”的界面文字。 |
nextStepstring | “下一步”的界面文字。 |
pageNumberstring | “页码”的界面文字。 |
prePagestring | “上一页”的界面文字。 |
preStepstring | “上一步”的界面文字。 |
resetCurrentPPTAnimationstring | “重置当前 PPT 文件的动画”的界面文字。 |
resetCurrentSlideAnimationstring | “重置当前 PPT 页的动画”的界面文字。 |
InvisibleCallbacks
InvisibleCallbacks<A>: {onAttributesUpdate:(attributes:A)=>void;onDestroy:()=>void}
- Defined in index-zh.d.ts:755
不可见插件的回调事件。
| 参数名 | 描述 |
|---|---|
AObject |
Type declaration
| 参数名 | 描述 | ||||
|---|---|---|---|---|---|
onAttributesUpdate(attributes:A)= & gt;void | 不可见插件属性更新的回调。
Parameters
| ||||
onDestroy()= & gt;void | 删除不可见插件的回调。
|
InvisiblePluginClass
InvisiblePluginClass<K, A, P>: {kind:K;onCreate?:(plugin:P)=>void;onDestroy?:(plugin:P)=>void}
- Defined in index-zh.d.ts:731
不可见插件。
| 参数名 | 描述 |
|---|---|
Kstring | |
AObject | |
PInvisiblePlugin & lt;A & gt; |
Type declaration
| 参数名 | 描述 | ||||
|---|---|---|---|---|---|
kindK | 插件的类型。 | ||||
onCreate(plugin:P)= & gt;void | 创建插件对象的回调。
Parameters
| ||||
onDestroy(plugin:P)= & gt;void | 删除插件对象的回调。
Parameters
|
InvisiblePluginContext
InvisiblePluginContext: {displayer:Displayer;kind:string}- Defined in index-zh.d.ts:716
不可见插件的上下文。
Type declaration
| 参数名 | 描述 |
|---|---|
displayerDisplayer | 不可见插件的 |
kindstring | 不可见插件的类型。 |
JoinRoomParams
JoinRoomParams: ConstructRoomParams&{disableDeviceInputs?:boolean;disableEraseImage?:boolean;disableMagixEventDispatchLimit?:boolean;disableNewPencil?:boolean;disablePencilWrittingLimitFrequency?:boolean;enableDrawPoint?:boolean;floatBar?:boolean|Partial<FloatBarOptions>;hotKeys?:Partial<HotKeys>;isWritable?:boolean;newPencilWritingQuality?:NewPencilWritingQuality;optimizeOptions?:OptimizeOptions;region?:string;rejectWhenReadonlyErrorLevel?:RoomErrorLevel;roomToken:string;uid:string;userPayload?:{};uuid:string}- Defined in index-zh.d.ts:4097
Room 对象的参数设置,用于加入互动白板实时房间。该类型继承 ConstructRoomParams 且包含以下属性:
-
uuid: string
房间的 UUID,即房间的唯一标识符。成功创建房间后会返回该属性。
-
uid: string
用户的 UID,即用户的唯一标识符,字符串格式,不能超过 1024 字节。请确保同一房间内每个用户
uid的唯一性。 -
region?: string
连接的数据中心,支持传入以下值:
表格内容超出当前宽度,可横向滚动查看更多列。region数据中心 服务区 us-sv美国硅谷 北美洲、南美洲 sg新加坡 新加坡、东亚、东南亚 in-mum印度孟买 印度 eu欧洲(法兰克福) 欧洲 cn-hz中国杭州 其他数据中心服务区未覆盖的地区 Note
- 该属性必须与要加入的互动白板实时房间所在数据中心一致,否则无法加入房间。
- 该属性与 WhiteWebSdkConfiguration 中的
region作用相同,二者只需要设置其中一个。如果同时设置,该属性会覆盖WhiteWebSdkConfiguration中的region。
-
roomToken: string
房间的 Room Token,用于加入房间时的用户鉴权。详见互动白板 Token 概述。
-
userPayload?: {[key: string]: any;}
自定义用户信息。该属性可以是任意类型的数据结构。
房间内其他用户可以通过如下代码读取特定用户在加入房间时设置的
userPayload:
example
for (var member of room.state.roomMembers) {
// 读取房间内某个用户的 userPayload 字段
console.log(member.userPayload);
}-
isWritable?: boolean
用户在房间中是否为互动模式(具有读写权限)。
-
true: (默认)互动模式,即具有读写权限。 -
false:订阅模式,即具有只读权限。该方法与
disableDeviceInputs的区别详见 《只读模式|禁止操作》。
-
-
disableDeviceInputs?: boolean
是否禁止用户通过鼠标、键盘、触摸屏幕操作白板工具。
-
true: 禁止用户操作白板工具。 -
false:(默认)允许用户操作白板工具。该方法与
isWritable的区别详见《禁止设备操作|禁止操作》。
-
-
enableDrawPoint?: boolean
是否允许使用铅笔工具(
pencil)画点。true: 允许。false:(默认)不允许。此时使用铅笔工具单击白板绘制的点不会保留在屏幕上。
Note
该属性只有在
disableNewPencil设为false时生效。 -
disableNewPencil?: boolean
自从:2.12.5
关闭/开启新铅笔工具:
true:(默认)关闭新铅笔工具。false: 开启新铅笔工具。开启后,SDK 会对铅笔工具(pencil)应用新版笔迹平滑算法,使书写笔迹更加流畅自然,并带有笔锋效果。
Note
为正常显示笔迹,在开启新铅笔前,请确保该房间内的所有用户使用如下 SDK:
- Android SDK 2.12.3 或更高版本
- iOS SDK 2.12.3 或更高版本
- Web SDK 2.12.5 或更高版本
-
disableMagixEventDispatchLimit?: boolean
自从:2.15.0
是否关闭发送自定义事件的频率限制:
true:关闭频率限制。可能会出现卡顿。false:(默认)开启频率限制。开启后,SDK 每隔 75 ms 发送一个事件。
-
disableEraseImage?: boolean
是否禁止橡皮擦除白板上的图片:
true: 禁止擦除。false:(默认)允许擦除。
-
disablePencilWrittingLimitFrequency?: boolean
自从:2.15.2
使用
pencil书写时,是否关闭笔迹同步的频率限制:true:关闭频率限制。笔迹会立即同步,但是可能会增加 CPU 性能消耗。false:(默认)开启频率限制。笔迹同步会有轻微延迟,但是可以降低 CPU 性能消耗。
-
floatBar?: boolean | Partial
当
currentApplianceName设为selector或text时,是否出现浮动条:true: 出现浮动条。false:(默认)不出现浮动条。
-
hotKeys?: Partial
添加自定义快捷键。若不传,则使用默认快捷键键方案,具体如下:
表格内容超出当前宽度,可横向滚动查看更多列。键盘按键 效果 Backspace 或 Delete 删除所选对象 Shift 锁定放缩长宽比,令其等比放缩 Ctrl + Z 或 Command + Z 撤回 Ctrl + Y 或 Command + Y 重做 Ctrl + C 或 Command + C 复制 Ctrl + V 或 Command + V 粘贴 如果你想关闭快捷键功能,可以将该属性的其值设为
{}。 -
rejectWhenReadonlyErrorLevel?: RoomErrorLevel
没有可写权限的用户进行写操作时,SDK 的应对方式。
-
optimizeOptions?: OptimizeOptions
since
2.16.48
白板绘制性能优化选项。详见 OptimizeOptions。
Level
Level: "debug"|"info"|"warn"|"error"- Defined in index-zh.d.ts:112
日志等级。
since
2.11.8
日志级别由高到低的排序为 error,warn,info,和 debug。选择一个级别,你就可以看到不低于该级别的所有日志信息。
例如,选择 info 级别,就可以看到 error、warn、info 级别的所有日志信息。
error:报错日志,表明出现了直接导致 SDK 无法正常运行的错误。warn:警告日志。当传入的参数不符合 SDK 要求时,SDK 会自动调整并发出警告。如果调用废弃 API,SDK 不会发出警告信息。info:信息日志,主要为连接状态。debug:调试日志,最详细的日志,目前内容与info一致。
LoggerOptions
LoggerOptions: {printLevelMask?:Level;reportDebugLogMode?:LoggerReportMode;reportLevelMask?:Level;reportQualityMode?:LoggerReportMode}- Defined in index-zh.d.ts:774
日志的配置参数。
Type declaration
| 参数名 | 描述 |
|---|---|
printLevelMaskLevel | 日志打印等级,详见 Level。默认等级为 |
reportDebugLogModeLoggerReportMode | SDK 上报 |
reportLevelMaskLevel | 日志上报等级,详见 Level。 |
reportQualityModeLoggerReportMode | SDK 上报连接质量数据的模式。 |
MagixEventListenerOptions
MagixEventListenerOptions: {fireInterval?:number;fireSelfEventAfterCommit?:boolean}- Defined in index-zh.d.ts:4741
自定义事件监听选项。
since
v2.15.2
Type declaration
| 参数名 | 描述 |
|---|---|
fireIntervalnumber | SDK 触发自定义事件回调的间隔,单位为毫秒,默认值为 500。取值必须 ≥ 500。 SDK 会根据该参数的值周期性触发自定义事件回调。 |
fireSelfEventAfterCommitboolean | 设置是否待服务器确认 dispatchMagixEvent 方法调用成功后再发送事件回调:
|
Margin
Margin: {bottom:number;left:number;right:number;top:number}- Defined in index-zh.d.ts:4817
空白区域的设置。
Type declaration
| 参数名 | 描述 |
|---|---|
bottomnumber | 下方的空白,单位为像素。 |
leftnumber | 左边的空白,单位为像素。 |
rightnumber | 右边的空白,单位为像素。 |
topnumber | 上方的空白,单位为像素。 |
MediaType
MediaType: "video"|"audio"- Defined in index-zh.d.ts:4788
媒体文件的类型。
video:视频文件。audio:音频文件。
MemberInformation
MemberInformation: {id:number;payload:any;session:string}- Defined in index-zh.d.ts:4533
自定义用户信息。
deprecated
已废弃。请改用 JoinRoomParams 中的 userPayload。
Type declaration
| 参数名 | 描述 |
|---|---|
idnumber | |
payloadany | |
sessionstring |
MemberState
MemberState: {arrowCompleteToSelector?:boolean;bold?:boolean;currentApplianceName:ApplianceNames;dottedLine?:boolean;ellipseCompleteToSelector?:boolean;fillColor?:Color;italic?:boolean;lineThrough?:boolean;rectangleCompleteToSelector?:boolean;shapeCompleteToSelector?:boolean;shapeType?:ShapeType;straightCompleteToSelector?:boolean;strokeColor:Color;strokeWidth:number;textCanSelectText?:boolean;textColor?:Color;textCompleteToSelector?:boolean;textSize:number;textSizeOverride?:number;underline?:boolean}- Defined in index-zh.d.ts:3093
互动白板实时房间的白板工具状态。
Type declaration
| 参数名 | 描述 |
|---|---|
arrowCompleteToSelectorboolean | 是否在画完箭头后自动切到选择工具:
|
boldboolean | 是否加粗:
|
currentApplianceNameApplianceNames | 当前使用的白板工具名称,详见 ApplianceNames。 |
dottedLineboolean | 是否支持绘制虚线(仅限铅笔工具):
|
ellipseCompleteToSelectorboolean | 是否在画完圆形后自动切到选择工具:
|
fillColorColor | 设置图形元素的填充色。仅适用于圆、矩形等封闭图形。 |
italicboolean | 是否使用斜体:
|
lineThroughboolean | 是否加删除线:
|
rectangleCompleteToSelectorboolean | 是否在画完矩形后自动切到选择工具:
|
shapeCompleteToSelectorboolean | 是否在画完三角、气泡等图形后自动切到选择工具:
|
shapeTypeShapeType | 绘制图形的类型。 |
straightCompleteToSelectorboolean | 是否在画完直线后自动切到选择工具:
|
strokeColorColor | 绘制线条的颜色,为 RGB 格式,例如 |
strokeWidthnumber | 绘制线条的粗细。 |
textCanSelectTextboolean | 是否允许直接选择并编辑文字:
|
textColorColor | 字体颜色,为 RGB 格式,例如 |
textCompleteToSelectorboolean | 是否在使用文字工具打完字后自动切到选择工具:
|
textSizenumber | 字体大小,取值必须大于 0。Chrome 浏览器对于小于 12 的字体会自动调整为 12。 |
textSizeOverridenumber | 设置文本工具的默认字体大小。如果不设置则默认使用 |
underlineboolean | 是否加下划线:
|
NativeEvent
NativeEvent: MouseEvent|WheelEvent|KeyboardEvent|TouchEvent- Defined in index-zh.d.ts:4546
浏览器的原生事件。
MouseEvent:鼠标事件,详见 MouseEvent。WheelEvent:滚轮事件,详见 WheelEvent。KeyboardEvent:键盘事件,详见 KeyboardEvent。TouchEvent:触摸事件,详见 TouchEvent。
PlayableCheckingParams
PlayableCheckingParams: {beginTimestamp?:number;duration?:number;region?:string;room:string;roomToken:string;slice?:string}- Defined in index-zh.d.ts:4205
检查白板房间是否可以回放的参数配置。
Type declaration
| 参数名 | 描述 | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
beginTimestampnumber | 回放的起始时间(单位为毫秒的 Unix 时间戳)。 该属性必须和 | ||||||||||||||||||
durationnumber | 回放的时长(毫秒)。 该属性必须和 | ||||||||||||||||||
regionstring | 当前房间所在的数据中心,支持传入以下值:
| ||||||||||||||||||
roomstring | 房间的 UUID,即房间的唯一标识符。成功创建房间后会返回该值。
| ||||||||||||||||||
roomTokenstring | 房间的 Room Token,用于加入房间时的用户鉴权。详见互动白板 Token 概述。 | ||||||||||||||||||
slicestring | 回放的录像片段的 UUID。你可以在房间录制的时候从 Note
|
PlayerCallbacks
PlayerCallbacks: DisplayerCallbacks&{onIsPlayableChanged:(isPlayable:boolean)=>void;onLoadFirstFrame:()=>void;onPhaseChanged:(phase:PlayerPhase)=>void;onPlayerStateChanged:(modifyState:Partial<PlayerState>)=>void;onProgressTimeChanged:(progressTimestamp:number)=>void;onStoppedWithError:(error:Error)=>void}- Defined in index-zh.d.ts:2930
PlayerCallbacks 包含白板回放的事件回调。该类型继承 DisplayerCallbacks 且包含以下成员:
-
onIsPlayableChanged: (isPlayable: boolean)=>void
isPlayable发生改变的回调。
param
isPlayable 是否能立即播放:
-
true:可以立即播放。 -
false:不能立即播放。 -
onPhaseChanged: (phase: PlayerPhase)=>void
回放阶段发生改变的回调。
param
phase 回放阶段。
-
onLoadFirstFrame: ()=>void
首帧加载完成的回调。
-
onPlayerStateChanged: (modifyState: Partial)=>void
回放状态发生改变的回调。
param
modifyState 回放状态。
-
onStoppedWithError: (error: Error)=>void
出错导致回放暂停的回调。
param
error 错误信息。
-
onProgressTimeChanged: (progressTimestamp: number)=>void
回放进度发生改变的回调。
param
progressTimestamp 回放进度。
PlayerState
PlayerState: DisplayerState&{observerMode:ObserverMode}- Defined in index-zh.d.ts:2895
Player 对象的状态。该类型继承 DisplayerState 且包含以下成员:
- observerMode: ObserverMode
白板回放的观看模式,详见 ObserverMode。
Plugin
Plugin<C, T>: {defaultAttributes?:T;hitTest?:(plugin:PluginInstance<C,T>, x:number, y:number, selectorRadius:number)=>boolean;kind?:string;render:ComponentType<PluginProps<C,T>>;willInterruptEvent?:(plugin:PluginInstance<C,T>, event:NativeEvent)=>boolean}
- Defined in index-zh.d.ts:549
组件插件的描述。Agora 支持的自定义插件包括组件插件和不可见插件。
| 参数名 | 描述 |
|---|---|
C | |
T |
Type declaration
| 参数名 | 描述 | ||||
|---|---|---|---|---|---|
defaultAttributesT | 属性的默认值。 | ||||
hitTest(plugin:PluginInstance & lt;C,T & gt;, x:number, y:number, selectorRadius:number)= & gt;boolean | 碰撞检测。你可以通过碰撞检测定义组件插件可以被选择工具选中的区域。
Parameters
| ||||
kindstring | 组件插件的类型,即该组件插件的唯一识别符。 | ||||
renderComponentType & lt;PluginProps & lt;C,T & gt; & gt; | 组件插件的外观。 | ||||
willInterruptEvent(plugin:PluginInstance & lt;C,T & gt;, event:NativeEvent)= & gt;boolean | 设置是否拦截该组件插件的原生事件。
Parameters
|
PluginDescription
PluginDescription<A>: {attributes?:A;height?:number;originX?:number;originY?:number;selectable?:boolean;width?:number}
- Defined in index-zh.d.ts:3435
组件插件对象的描述。
| 参数名 | 描述 |
|---|---|
A |
Type declaration
| 参数名 | 描述 |
|---|---|
attributesA | 组件插件对象的属性。 |
heightnumber | 组件插件对象的高。 |
originXnumber | 组件插件对象的左上角在世界坐标系(以白板初始化时的中心点为原点的坐标系)中的 X 轴坐标。 |
originYnumber | 组件插件对象的左上角在世界坐标系(以白板初始化时的中心点为原点的坐标系)中的 Y 轴坐标。 |
selectableboolean | 能否选中组件插件对象:
|
widthnumber | 组件插件对象的宽。 |
PluginProps
PluginProps<C, T>: {margin:Margin;origin:Point;plugin:PluginInstance<C,T>;scale:number;size:Size}
- Defined in index-zh.d.ts:3298
组件插件的外观设置。
| 参数名 | 描述 |
|---|---|
C | |
T |
Type declaration
| 参数名 | 描述 |
|---|---|
marginMargin | 组件插件图标周围的空白。 |
originPoint | 组件插件图标的中心点在世界坐标系中(以白板初始化时的中心点为原点的坐标系)的坐标。 |
pluginPluginInstance & lt;C,T & gt; | 组件插件对象。 |
scalenumber | 组件插件图标的缩放比例。 |
sizeSize | 组件插件图标的大小。 |
Point
Point: {x:number;y:number}- Defined in index-zh.d.ts:4839
世界坐标系(以白板初始化时的中心点为原点的坐标系)的点坐标。
Type declaration
| 参数名 | 描述 |
|---|---|
xnumber | 点在世界坐标系中的 X 轴坐标。 |
ynumber | 点在世界坐标系中的 Y 轴坐标。 |
PptDescription
PptDescription: {height:number;previewURL?:string;src:string;width:number}- Defined in index-zh.d.ts:3491
图片或动态 PPT 页的描述。
你可以在初始化 WhiteScene 时配置 PptDescription,以在白板上插入图片或动态 PPT。
支持的图片或动态 PPT 格式包括:
- PNG、JPG/JPEG、WEBP 格式的图片,或由 PPT、PPTX、DOC、DOCX、PDF 格式的文件转换成 PNG、JPG/JPEG、WEBP 格式的图片。
- 使用 文档转换功能转换过的 PPTX 文件。
Note
- 一个场景只能插入一张图片或动态 PPT 页。
- 插入的图片或动态 PPT 页的中心点坐标默认为世界坐标系的原点。图片或动态 PPT 页插入场景后,你无法改变它在白板上的位置。
Type declaration
| 参数名 | 描述 |
|---|---|
heightnumber | 图片或动态 PPT 在白板中的高度,单位为像素。 |
previewURLstring | 图片或动态 PPT 预览图的 URL 地址。动态 PPT 预览图的 URL 地址可以从查询转换任务进度中的 |
srcstring | 图片或动态 PPT 页的地址,支持的格式如下:
|
widthnumber | 图片或动态 PPT 在白板中的宽度,单位为像素。 |
PreviewConfig
PreviewConfig: {international?:International}- Defined in index-zh.d.ts:4482
PPT 预览页面的配置。
Type declaration
| 参数名 | 描述 |
|---|---|
internationalInternational | 给预览页面的菜单栏添加界面文字。详见 International。 |
Progress
Progress: {convertedFileList:ConvertedFile[];convertedPageSize:number;convertedPercentage:number;currentStep?:CurrentStep;totalPageSize:number}- Defined in index-zh.d.ts:4878
文档转换任务的进度详情。
Type declaration
| 参数名 | 描述 |
|---|---|
convertedFileListConvertedFile[] | 转换后生成的图片或动态 PPT 页。 |
convertedPageSizenumber | 已转换的页数。 |
convertedPercentagenumber | 转换进度的百分比。 |
currentStepCurrentStep | 转换任务当前的步骤。 |
totalPageSizenumber | 总页数。 |
RTCClient
RTCClient: {adjustAudioMixingPlayoutVolume?:(volume:number)=>number;adjustAudioMixingPublishVolume?:(volume:number)=>number;adjustAudioMixingVolume?:(volume:number)=>number;getAudioMixingCurrentPosition?:()=>number;getAudioMixingDuration?:()=>number;getAudioMixingPlayoutVolume?:()=>number;getAudioMixingPublishVolume?:()=>number;pauseAudioMixing:()=>number;resumeAudioMixing:()=>number;setAudioMixingPosition:(position:number)=>number;startAudioMixing:(filePath:string, loopback:boolean, replace:boolean, cycle:number, callback?:(state:number, errorCode:number)=>void)=>number;stopAudioMixing:(callback?:(state:number, errorCode:number)=>void)=>number}- Defined in index-zh.d.ts:4944
AgoraRTCClient 类用于桥接 Agora RTC SDK 的混音方法和白板 SDK。
当用户同时使用音视频功能和互动白板,且在互动白板中展示的动态 PPT 包含音频文件时,可能遇到以下问题:
- 播放 PPT 内的音频时声音很小。
- 播放 PPT 内的音频时有回声。
为解决上述问题,你可以使用 AgoraRTCClient 类调用 Agora RTC SDK 的混音方法播放动态 PPT 中的音频文件。
Note
目前仅支持 Electron 平台的 Agora RTC SDK.
Type declaration
| 参数名 | 描述 | ||||||||
|---|---|---|---|---|---|---|---|---|---|
adjustAudioMixingPlayoutVolume(volume:number)= & gt;number | 调节音乐文件的本地播放音量。
Parameters
| ||||||||
adjustAudioMixingPublishVolume(volume:number)= & gt;number | 调节音乐文件的远端播放音量。
Parameters
| ||||||||
adjustAudioMixingVolume(volume:number)= & gt;number | 调节音乐文件的播放音量。 该方法调节混音里伴奏在本端和远端播放的音量。
Parameters
| ||||||||
getAudioMixingCurrentPosition()= & gt;number | 获取音乐文件的播放进度。
| ||||||||
getAudioMixingDuration()= & gt;number | 获取指定音乐文件的总时长。
| ||||||||
getAudioMixingPlayoutVolume()= & gt;number | 获取音乐文件的本地播放音量。
| ||||||||
getAudioMixingPublishVolume()= & gt;number | 获取音乐文件的远端播放音量。
| ||||||||
pauseAudioMixing()= & gt;number | 暂停播放音乐文件及混音。
| ||||||||
resumeAudioMixing()= & gt;number | 恢复播放音乐文件及混音。
| ||||||||
setAudioMixingPosition(position:number)= & gt;number | 设置音乐文件的播放位置。 该方法可以设置音频文件的播放位置,这样你可以根据实际情况播放文件,而不是非得从头到尾播放一个文件。
Parameters
| ||||||||
startAudioMixing(filePath:string, loopback:boolean, replace:boolean, cycle:number, callback?:(state:number, errorCode:number)= & gt;void)= & gt;number | 开始播放音乐文件及混音。
Parameters
| ||||||||
stopAudioMixing(callback?:(state:number, errorCode:number)= & gt;void)= & gt;number | 停止播放音乐文件及混音。
Parameters
|
ReconnectionOptions
ReconnectionOptions: {disableReconnect:boolean}- Defined in index-zh.d.ts:90
断线重连设置。
Type declaration
| 参数名 | 描述 |
|---|---|
disableReconnectboolean | 是否关闭断线重连:
|
Rectangle
Rectangle: Size&{originX:number;originY:number}- Defined in index-zh.d.ts:192
视觉矩形的描述。该类继承 Size 且包含以下成员:
-
originX: number
视觉矩形左上角原点在世界坐标系(以白板初始化时的中心点为原点的坐标系)中的 X 轴坐标。
-
originY: number
视觉矩形左上角原点在世界坐标系(以白板初始化时的中心点为原点的坐标系)中的 Y 轴坐标。
RenderPlugin
RenderPlugin<C, T>: {defaultAttributes?:T;hitTest?:(plugin:PluginInstance<C,T>, x:number, y:number, selectorRadius:number)=>boolean;kind:string;render:ComponentType<PluginProps<C,T>>;willInterruptEvent?:(plugin:PluginInstance<C,T>, event:NativeEvent)=>boolean}
- Defined in index-zh.d.ts:4551
组件插件的渲染。
| 参数名 | 描述 |
|---|---|
C | |
T |
Type declaration
| 参数名 | 描述 | ||||
|---|---|---|---|---|---|
defaultAttributesT | 组件插件属性的默认值。 | ||||
hitTest(plugin:PluginInstance & lt;C,T & gt;, x:number, y:number, selectorRadius:number)= & gt;boolean | 碰撞检测。你可以通过碰撞检测定义组件插件可以被选择工具选中的区域。
Parameters
| ||||
kindstring | 组件插件类型,为该组件插件的唯一识别符。 | ||||
renderComponentType & lt;PluginProps & lt;C,T & gt; & gt; | 组件插件的外观。 | ||||
willInterruptEvent(plugin:PluginInstance & lt;C,T & gt;, event:NativeEvent)= & gt;boolean | 设置是否拦截该组件插件的原生事件。
Parameters
|
ReplayRoomParams
ReplayRoomParams: ConstructRoomParams&{alignmentInterval?:number;alignmentThreshold?:number;beginTimestamp?:number;crops?:Array<{from:number;to:number}>;duration?:number;region?:string;room:string;roomToken:string;slice?:string}- Defined in index-zh.d.ts:4188
Player 对象的参数配置,用于白板回放。该类型继承 ConstructRoomParams 且增加以下属性:
-
region?: string
Player对象所在的数据中心。支持传入以下值: 表格内容超出当前宽度,可横向滚动查看更多列。region数据中心 服务区 us-sv美国硅谷 北美洲、南美洲 sg新加坡 新加坡、东亚、东南亚 in-mum印度孟买 印度 eu欧洲(法兰克福) 欧洲 cn-hz中国杭州 其他数据中心服务区未覆盖的地区 Note
- 如果你不设置该属性,SDK 会使用 WhiteWebSdkConfiguration 中
region的值。 - 如果在初始化
WhiteWebSdk对象和创建Player对象时都没有设置数据中心,SDK 会报错。
- 如果你不设置该属性,SDK 会使用 WhiteWebSdkConfiguration 中
-
slice?: string
回放的录像片段的 UUID。你可以在房间录制的时候从
room.slice获取。Note
- 该属性需要和
room同时传入。 - 传入该属性表明只回放特定片段,因此禁止再传入
beginTimestamp和duration。
- 该属性需要和
-
room: string
回放房间的 UUID,即房间的唯一标识符。成功创建房间后会返回该值。
- 如果只传该属性,不传
beginTimestamp和duration,则表明回放该房间的所有录像片段。 - 如果同时传入该属性和
beginTimestamp和duration,则表明回放该房间在对应时间范围内的所有录像片段。
- 如果只传该属性,不传
-
roomToken: string
房间的 Room Token,用于加入房间时的用户鉴权。详见互动白板 Token 概述。
-
beginTimestamp?: number
白板回放的起始时间(单位为毫秒的 Unix 时间戳)。
该属性必须和
room、duration一起使用,而且使用时禁止传入slice。 -
duration?: number
白板回放的时长(毫秒)。
该属性必须和
room、beginTimestamp一起使用,而且使用时禁止传入slice。 -
crops?: Array
since
2.16.48
回放录像裁剪区间,包含以下属性:
-
from: number。裁剪区间起点时间戳。 -
to: number。裁剪区间终点时间戳。 -
alignmentThreshold?: number
since
2.16.48
回放时间轴对齐阈值, 超过此阈值会对齐回放播放器时间, 单位 ms, 默认值为 600 ms。
- alignmentInterval?: number
since
2.16.48
回放时间轴对齐时长, 即在此段时间内,将回放时间通过倍速播放对齐到外部时间戳, 单位 ms, 默认值为 3000 ms。
RoomCallbacks
RoomCallbacks: DisplayerCallbacks&{onCanRedoStepsUpdate:(canRedoSteps:number)=>void;onCanUndoStepsUpdate:(canUndoSteps:number)=>void;onConnection:(duration:number)=>void;onDisconnectWithError:(error:Error)=>void;onKeyDown:(event:KeyboardEvent)=>void;onKeyUp:(event:KeyboardEvent)=>void;onKickedWithReason:(reason:string)=>void;onObjectsLimit:(limit:number, soft:boolean)=>void;onPhaseChanged:(phase:RoomPhase)=>void;onRoomStateChanged:(modifyState:Partial<RoomState>)=>void;willInterceptKeyboardEvent:(event:KeyboardEvent)=>boolean}- Defined in index-zh.d.ts:2720
RoomCallbacks 包含白板房间的事件回调。该类型继承 DisplayerCallbacks 并增加以下成员:
-
onConnection: (duration: number)=>void
房间连接成功回调,报告已经建立 WebSocket 连接,将要进入初始化阶段。
param
duration 建立连接的时间,单位是毫秒。
-
onPhaseChanged: (phase: RoomPhase)=>void
房间连接状态发生变化的回调。
param
phase 房间的连接状态,详见 RoomPhase。你可以阅读管理房间连接状态了解更多信息。
-
onRoomStateChanged: (modifyState: Partial)=>void
房间状态属性发生变化回调。
该回调仅返回发生变化的房间状态属性,未发生变化的房间状态字段均为空。
param
modifyState 发生变化的房间状态属性,详见 RoomState。
-
onDisconnectWithError: (error: Error)=>void
白板 SDK 与白板服务器连接中断回调。
param
error 错误信息。
-
onObjectsLimit: limit: number, soft: boolean)=>void
白板中的元素数量超过限制回调。
param
limit 白板中的元素数量限制。
param
soft 是否为软限制:
-
true:软限制。当白板中的元素数量超过限制时,SDK 会发出警告,但仍可以插入白板元素。 -
false:硬限制。当白板中的元素数量超过限制时,SDK 会发出警告,本次添加元素操作无效,房间状态会被强制回退至操作前,且后端会将进行本次操作的用户踢出频道。 -
onKickedWithReason: (reason: string)=>void
用户被服务器移出房间回调。
param
reason 用户被移出房间的原因。
reason 字段 | 描述 |
|---|---|
| kickByAdmin | 被管理员踢出 |
| roomDelete | 房间被删除 |
| roomZombie | 房间不活跃 |
| roomBan | 房间被封禁 |
| GatewayAdjust | 网关调整 |
| replaceByOther | 被另一个用户顶替,当前用户被迫下线 |
| crash | 服务器崩溃 |
-
onCanUndoStepsUpdate: (canUndoSteps: number)=>void
可撤销次数发生变化回调。
当本地用户调用 undo 撤销上一步操作时,会触发该回调,报告剩余的可撤销次数。
param
canUndoSteps 剩余的可撤销次数。
-
onCanRedoStepsUpdate: (canRedoSteps: number)=>void
可重做次数发生变化回调。
当本地用户调用 undo 重做上一步操作时,会触发该回调,报告剩余的可重做次数。
param
canRedoSteps 剩余的可重做次数。
-
willInterceptKeyboardEvent: (event: KeyboardEvent)=>boolean
是否拦截监听的键盘事件:
true: 拦截。拦截后,该键盘事件不会触发回调。false: 不拦截。
-
onKeyDown: (event: KeyboardEvent)=>void
键盘按下事件回调。
-
onKeyUp: (event: KeyboardEvent)=>void
键盘松开事件回调。
RoomMember
RoomMember: {memberId:number;memberState:MemberState;payload:UserPayload;session:string}- Defined in index-zh.d.ts:2986
实时房间内互动模式(具有读写权限)用户的信息。
Type declaration
| 参数名 | 描述 |
|---|---|
memberIdnumber | 用户 ID。 在用户加入互动白板实时房间时,会自动分配用户 ID,用于标识房间内的用户。同一房间中的每个用户具有唯一的用户 ID。 |
memberStateMemberState | 用户所有的白板工具状态,详见 MemberState。 |
payloadUserPayload | 自定义用户信息,在用户加入房间时传入。详见 UserPayload。 since v2.15.0 |
sessionstring | 当前的 session ID。 |
RoomState
RoomState: DisplayerState&{broadcastState:Readonly<BroadcastState>;memberState:MemberState}- Defined in index-zh.d.ts:3040
互动白板实时房间的所有状态。该类继承 DisplayerState 且包含以下成员:
-
memberState: MemberState
当前使用的白板工具,详见 MemberState。
-
broadcastState: Readonly
当前的视角状态。
SceneDefinition
SceneDefinition: {name?:string;ppt?:PptDescription}- Defined in index-zh.d.ts:2748
场景定义。
Type declaration
| 参数名 | 描述 |
|---|---|
namestring | 场景名称。 |
optional | 在场景中展示的图片或动态 PPT。每个场景中可以展示一张图片或一页动态 PPT,你可以通过 |
SceneMap
SceneMap: {}- Defined in index-zh.d.ts:1507
场景列表。
Type declaration
| 参数名 | 描述 |
|---|---|
[dirPathstring]:WhiteScene[] | 某一场景目录下的所有场景。 |
SceneState
SceneState: {contextPath:string;index:number;sceneName:string;scenePath:string;scenes:ReadonlyArray<WhiteScene>}- Defined in index-zh.d.ts:3048
场景状态。
Type declaration
| 参数名 | 描述 |
|---|---|
contextPathstring | 当前场景所属场景目录的路径。 since 2.10.3 |
indexnumber | 当前场景在所属场景目录中的索引号。 |
sceneNamestring | 当前场景的名称。 since 2.10.3 |
scenePathstring | 当前场景的路径。 |
scenesReadonlyArray & lt;WhiteScene & gt; | 当前场景目录下所有场景的列表。 |
ScenesCallbacks
ScenesCallbacks: {onAddScene:(scenesCallbacks:ScenesCallbacksNode, name:string)=>void;onAddSceneGroup:(scenesCallbacks:ScenesCallbacksNode, name:string)=>void;onRemoveScene:(scenesCallbacks:ScenesCallbacksNode, name:string)=>void;onRemoveSceneGroup:(scenesCallbacks:ScenesCallbacksNode, name:string)=>void;onScenesCountUpdate:(scenesCallbacks:ScenesCallbacksNode, scenesCount:number)=>void;onScenesGroupCountUpdate:(scenesCallbacks:ScenesCallbacksNode, sceneGroupsCount:number)=>void}- Defined in index-zh.d.ts:4685
场景回调。
Type declaration
| 参数名 | 描述 | ||||
|---|---|---|---|---|---|
onAddScene(scenesCallbacks:ScenesCallbacksNode, name:string)= & gt;void | 新增场景回调。 param场景目录的信息。详见 ScenesCallbacksNode。 param新增场景的场景名称。
Parameters
| ||||
onAddSceneGroup(scenesCallbacks:ScenesCallbacksNode, name:string)= & gt;void | 新增子场景目录回调。 param场景目录的信息。详见 ScenesCallbacksNode。 param新增的子场景目录的名称。
Parameters
| ||||
onRemoveScene(scenesCallbacks:ScenesCallbacksNode, name:string)= & gt;void | 删除场景回调。 param场景目录的信息。详见 ScenesCallbacksNode。 param被删除场景的场景名称。
Parameters
| ||||
onRemoveSceneGroup(scenesCallbacks:ScenesCallbacksNode, name:string)= & gt;void | 删除子场景目录回调。 param场景目录的信息。详见 ScenesCallbacksNode。 param被删除的子场景目录的名称。
Parameters
| ||||
onScenesCountUpdate(scenesCallbacks:ScenesCallbacksNode, scenesCount:number)= & gt;void | 指定场景目录下场景数量发生变化回调。 param场景目录的信息。详见 ScenesCallbacksNode。 param指定场景目录下当前的场景数量。
Parameters
| ||||
onScenesGroupCountUpdate(scenesCallbacks:ScenesCallbacksNode, sceneGroupsCount:number)= & gt;void | 指定场景目录下子场景目录数量发生变化回调。 param场景目录的信息。详见 ScenesCallbacksNode。 param指定场景目录下当前子场景目录的数量。
Parameters
|
Size
Size: {height:number;width:number}- Defined in index-zh.d.ts:200
尺寸大小。
Type declaration
| 参数名 | 描述 |
|---|---|
heightnumber | 高度。 |
widthnumber | 宽度。 |
TextFormat
TextFormat: {bold?:boolean;color?:Color;fontSize?:number;italic?:boolean;lineThrough?:boolean;underline?:boolean}- Defined in index-zh.d.ts:4598
字体样式。
Type declaration
| 参数名 | 描述 |
|---|---|
boldboolean | 是否加粗:
|
colorColor | 颜色,RGB 格式。例如, |
fontSizenumber | 字体大小,取值必须大于 0。 |
italicboolean | 是否使用斜体:
|
lineThroughboolean | 是否加删除线:
|
underlineboolean | 是否加下划线:
|
UserCursorIcons
UserCursorIcons: {}- Defined in index-zh.d.ts:4853
用户自定义图标。
Type declaration
| 参数名 | 描述 |
|---|---|
[keystring]:ReadonlyArray & lt;string & gt; |
UserFonts
UserFonts: {}- Defined in index-zh.d.ts:335
自定义字体。
Type declaration
| 参数名 | 描述 |
|---|---|
[fontstring]:string |
|
UserPayload
UserPayload: {}&{uid:string}- Defined in index-zh.d.ts:3024
自定义用户信息。
-
[key: string]: any
key-value 结构的自定义用户信息,例如,
"avatar", "https://example.com/user.png"。 -
uid: string
用户标识,字符串格式,不能超过 1024 字节。
请确保同一房间内每个用户
uid的唯一性。
since
v2.15.0
WhiteScene
WhiteScene: {name:string;ppt?:PptDescription}- Defined in index-zh.d.ts:4640
白板场景。
Type declaration
| 参数名 | 描述 |
|---|---|
namestring | 场景名称。 |
optional | 在场景中展示的图片或动态 PPT。每个场景中可以展示一张图片或一页动态 PPT,你可以通过 PptDescription 设置待插入图片或动态 PPT 的宽、高、资源地址或预览图等。 |
WhiteWebSdkConfiguration
WhiteWebSdkConfiguration: {appIdentifier:string;deviceType?:DeviceType;disableCurveAnimes?:boolean;disableNewPencilStroke?:boolean;disableRotation?:boolean;fontFamily?:string;fonts?:UserFonts;handToolKey?:string;invisiblePlugins?:ReadonlyArray<InvisiblePluginClass<string,any,any>>;loggerOptions?:LoggerOptions;onWhiteSetupFailed?:(error:Error)=>void;onlyCallbackRemoteStateModify?:boolean;plugins?:Plugins;preloadDynamicPPT?:boolean;reconnectionOptions?:Partial<ReconnectionOptions>|false;region?:string;renderEngine?:RenderEngine;screenType?:ScreenType;urlInterrupter?:(url:string)=>string;useMobXState?:boolean;wrappedComponents?:WrappedComponents}- Defined in index-zh.d.ts:3708
WhiteWebSdk 对象的配置。
Note
成功初始化 WhiteWebSdk 后,无法再调用 WhiteWebSdkConfiguration 中的任何方法修改 WhiteWebSdk 的配置。
Type declaration
| 参数名 | 描述 | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
appIdentifierstring | 白板项目的唯一标识。详见获取互动白板项目的安全密钥。 | ||||||||||||||||||
deviceTypeDeviceType | 该客户端的设备类型,决定 SDK 如何处理鼠标事件和触碰事件。 如果填写错误,会导致 SDK 对设备输入的响应行为不符合预期。如果不填,SDK 会根据内在逻辑自动判断设备的类型。 | ||||||||||||||||||
disableCurveAnimesboolean | 是否关闭新铅笔工具(
note该属性仅在 | ||||||||||||||||||
disableNewPencilStrokeboolean | |||||||||||||||||||
disableRotationboolean | 是否关闭图片旋转:
| ||||||||||||||||||
fontFamilystring | 文字工具( | ||||||||||||||||||
fontsUserFonts | 自定义字体。 为显示动态 PPT 中的非常规字体,你需要先将字体文件上传到自己的业务服务器或云存储中并生成 URL 地址,然后在初始化 | ||||||||||||||||||
handToolKeystring | 抓手工具对应的快捷键。 按下该键时,会自动切换成抓手工具( | ||||||||||||||||||
invisiblePluginsReadonlyArray & lt;InvisiblePluginClass & lt;string,any,any & gt; & gt; | 不可见插件。 | ||||||||||||||||||
loggerOptionsLoggerOptions | SDK 上报日志的选项,详见 LoggerOptions。 | ||||||||||||||||||
onWhiteSetupFailed(error:Error)= & gt;void |
example该回调仅用于网络或鉴权失败时的错误处理。如果是因为参数原因初始化失败,会在调用
Parameters
| ||||||||||||||||||
onlyCallbackRemoteStateModifyboolean | 是否开启仅接收远端用户状态改变回调:
| ||||||||||||||||||
pluginsPlugins | 组件插件。 | ||||||||||||||||||
preloadDynamicPPTboolean | 是否在加载动态 PPT 首页时,一次性加载动态 PPT 中的所有图片资源:
Note Agora 不推荐设置 | ||||||||||||||||||
reconnectionOptionsPartial & lt;ReconnectionOptions & gt; | false | 断线重连设置。默认开启自动断线重连。 如果要关闭断线重连,你可以将 | ||||||||||||||||||
regionstring | 数据中心,支持传入以下值:
Note 该方法设置的数据中心必须与创建房间时设置的数据中心一致;否则,SDK 将无法连接到房间。 | ||||||||||||||||||
renderEngineRenderEngine | 白板上绘画的渲染模式。默认为 | ||||||||||||||||||
screenTypeScreenType | 该客户端的屏幕类型,用于调整手势识别参数。默认为 | ||||||||||||||||||
urlInterrupter(url:string)= & gt;string | 将白板中图片等资源的 URL 拦截并替换。 例如,你可以使用如下代码给所有图片的 URL 增加尾缀: example
Parameters
| ||||||||||||||||||
useMobXStateboolean | 是否用 MobX 监听
| ||||||||||||||||||
wrappedComponentsWrappedComponents | 由 你可以使用如下代码对白板的界面进行自定义包装: example |
WorldViewRectangle
WorldViewRectangle: {height:number;originX:number;originY:number;width:number}- Defined in index-zh.d.ts:3569
配置视觉矩形。
视觉矩形是用户的视角必须容纳的区域。设置好视觉矩形后,SDK 会自动将视角会调整到刚好可以完整展示视觉矩形所表示的范围。
你可以根据要展示的 PPT 幻灯片或图像的尺寸设置视觉矩形,以确保相同的内容在不同尺寸的屏幕上都可以完整显示。
Type declaration
| 参数名 | 描述 |
|---|---|
heightnumber | 视觉矩形的高度。 视觉矩形的高度不能小于实际展示内容的宽度,否则用户将看不见超出的部分。 |
originXnumber | 视觉矩形左上角在世界坐标系(以白板初始化时的中心点为原点的坐标系)中的 X 轴坐标。 |
originYnumber | 视觉矩形左上角在世界坐标系(以白板初始化时的中心点为原点的坐标系)中的 Y 轴坐标。 |
widthnumber | 视觉矩形的宽度。 视觉矩形的宽度不能小于实际展示内容的宽度,否则用户将看不见超出的部分。 |
WrappedComponents
WrappedComponents: ReadonlyArray<ComponentType<{}>>- Defined in index-zh.d.ts:230
由 React.ComponentType 类型组成的数组,用于包装白板的界面。默认值为 []。
Variables
Const AdminObserverId
AdminObserverId: number
- Defined in index-zh.d.ts:19
系统事件触发者的用户 ID。
Const AkkoVersion
AkkoVersion: any
- Defined in index-zh.d.ts:14
Akko 的版本。
Const DefaultHotKeys
DefaultHotKeys: Partial<HotKeys>
- Defined in index-zh.d.ts:978
默认的快捷键。
| 键盘按键 | 效果 |
|---|---|
| Backspace 或 Delete | 删除所选对象 |
| Shift | 锁定放缩长宽比,令其等比放缩 |
| Ctrl + Z 或 Command + Z | 撤回 |
| Ctrl + Y 或 Command + Y | 重做 |
| Ctrl + C 或 Command + C | 复制 |
| Ctrl + V 或 Command + V | 粘贴 |
Const DisplayerConsumer
DisplayerConsumer: Consumer<Displayer>
- Defined in index-zh.d.ts:3078
Displayer 对象的 Consumer。
Const PlayerConsumer
PlayerConsumer: Consumer<Player|undefined>
- Defined in index-zh.d.ts:3088
Player 对象的 Consumer。
Const RoomConsumer
RoomConsumer: Consumer<Room|undefined>
- Defined in index-zh.d.ts:3083
Room 对象的 Consumer。
Const WhiteVersion
WhiteVersion: string
- Defined in index-zh.d.ts:9
当前 SDK 的版本号,格式为字符串,如 "2.12.11"。
Functions
contentModeAspectFill
contentModeAspectFill(): ContentMode- Defined in index-zh.d.ts:1421
等比例缩放视角,使视角边界的短边正好顶住与其垂直的屏幕的两边,以保证视角边界铺满屏幕。
| 返回类型 | 描述 |
|---|---|
视角的实时缩放比例。 |
contentModeAspectFillScale
contentModeAspectFillScale(scale: number): ContentMode- Defined in index-zh.d.ts:1429
等比例缩放视角,使视角边界的短边正好顶住与其垂直的屏幕的两边,以保证视角边界铺满屏幕;在此基础上再将视角边界缩放指定的倍数。
| 参数名 | 描述 |
|---|---|
scalenumber | 在等比例缩放的基础上再缩放视角边界的倍数。 |
| 返回类型 | 描述 |
|---|---|
视角的实时缩放比例。 |
contentModeAspectFit
contentModeAspectFit(): ContentMode- Defined in index-zh.d.ts:1398
等比例缩放视角,使视角边界的长边正好顶住与其垂直的屏幕的两边,以保证在屏幕上完整展示视角边界。
| 返回类型 | 描述 |
|---|---|
实时缩放比例。 |
contentModeAspectFitScale
contentModeAspectFitScale(scale: number): ContentMode- Defined in index-zh.d.ts:1406
等比例缩放视角,使视角边界的长边正好顶住与其垂直的屏幕的两边,以保证在屏幕上完整展示视角边界;在此基础上,再将视角边界缩放指定的倍数。
| 参数名 | 描述 |
|---|---|
scalenumber | 在等比例缩放的基础上再缩放视角边界的倍数。 |
| 返回类型 | 描述 |
|---|---|
实时缩放比例。 |
contentModeAspectFitSpace
contentModeAspectFitSpace(space: number): ContentMode- Defined in index-zh.d.ts:1414
等比例缩放视角,使视角边界的长边正好顶住与其垂直的屏幕的两边;在此基础上,在视角边界的四周填充指定的空白空间。
| 参数名 | 描述 |
|---|---|
spacenumber | 在等比例缩放的基础上再填充的空白空间,单位为像素。 |
| 返回类型 | 描述 |
|---|---|
实时缩放比例。 |
contentModeScale
contentModeScale(scale: number): ContentMode- Defined in index-zh.d.ts:1392
按指定的比例缩放视角边界。
| 参数名 | 描述 |
|---|---|
scalenumber | 指定的缩放比例。 |
| 返回类型 | 描述 |
|---|---|
实时缩放比例。 |
createPlugins
createPlugins<C_MAP>(plugins: Readonly<{}>): Plugins<C_MAP>- Defined in index-zh.d.ts:542
创建插件。
| 参数名 | 描述 |
|---|---|
C_MAPObject |
| 参数名 | 描述 |
|---|---|
pluginsReadonly & lt;\{\} & gt; | 创建的插件。 |
| 返回类型 | 描述 |
|---|---|
Plugins<C_MAP> |
injectCustomStyle
injectCustomStyle(icons: UserCursorIcons): void- Defined in index-zh.d.ts:3597
添加自定义的图标。
| 参数名 | 描述 |
|---|---|
iconsUserCursorIcons | 自定义的图标。 |
| 返回类型 | 描述 |
|---|---|
void |
isPlayer
isPlayer(displayer: Displayer): boolean- Defined in index-zh.d.ts:929
判断 Displayer 对象是否为 Player 对象。
| 参数名 | 描述 |
|---|---|
displayerDisplayer |
|
| 返回类型 | 描述 |
|---|---|
boolean | 该
|
isRoom
isRoom(displayer: Displayer): boolean- Defined in index-zh.d.ts:918
判断 Displayer 对象是否为 Room 对象。
| 参数名 | 描述 |
|---|---|
displayerDisplayer |
|
| 返回类型 | 描述 |
|---|---|
boolean |
|
setAsyncModuleLoadMode
setAsyncModuleLoadMode(mode: AsyncModuleLoadMode): void- Defined in index-zh.d.ts:835
设置异步模块的加载模式。
| 参数名 | 描述 |
|---|---|
required | 异步模块的加载模式,详见 AsyncModuleLoadMode。 |
| 返回类型 | 描述 |
|---|---|
void |