演示模式 (Presentation Mode)

演示模式主要用于第三方系统中的内容分发与展示场景，如在线题库、课件系统等。

场景特点

• 轻量高效：不加载编辑工具集，资源占用更小。
• 深度控制：支持通过 API 精确干预画板状态。

实例创建

import { createPresentation, EmbeddedPresentation } from '@dajiaoai/algeo-sdk';

/**
 * @param container 挂载的 DOM 节点
 * @param options 初始化选项
 */
const presentation: EmbeddedPresentation = await createPresentation(container, {
  shareId: '可选初始 ID',
});

API 参考

loadShareById(id: string): Promise<Result>

根据大角几何分享 ID 加载内容。

• 参数: id: string (如 '33TA3484')
• 返回: 加载成功或失败的元数据。

loadFile(content: FileContentV10): Promise<Result>

加载符合 FileContentV10 协议的结构化 JSON 数据。

• 参数: content: DSL 协议详情

switchSlide(index: number): Promise<Result>

跳转到指定序号的画板（从 0 开始计数）。

• 参数: index: number

getSlideCount(): Promise<{ count: number }>

获取当前文档的总画板数量。

repl(command: string): Promise<Result>

核心 API：向画板发送 REPL 执行序列。可用于自动化绘图、设置参数等。

• 示例: presentation.repl('P1(2,3); P2(-1,0); SEG(P1, P2);')
• 详细指令: 查看 REPL 完整手册

destroy(): void

销毁当前实例，移除 DOM 内容并释放通信监听。

事件订阅

on(event, listener) 返回一个取消订阅函数，应在组件卸载或实例销毁前调用以避免内存泄漏。

// 订阅 ready 事件，画板就绪后再执行后续操作
const unsubscribe = presentation.on('ready', (event) => {
  console.log('画板就绪，iframe 版本：', event.version);
  console.log('当前模式：', event.mode);
});

// 不再需要时取消订阅
unsubscribe();

事件名	触发时机	回调参数类型
ready	iframe 完成初始化，可开始调用方法	{ type: 'ready', mode: string, version: string | null }