统一笔记

适用于 Whiteboard HarmonyOS SDK 0.2.11。

统一笔记通过 originSize 固定书写参考尺寸，便于不同屏幕比例的客户端以一致的课件坐标显示和编辑笔记。MainView、Slide、Presentation 分别配置；MainView 的配置不会自动继承给课件。

主白板参考尺寸

TypeScript

const windowParams = new WindowParams()
  .setOriginSize({ width: 1280, height: 720 })
  .setPageScaleRange({ minScale: 0.5, maxScale: 4 });
// 将 windowParams 传入 WhiteboardOptions。

width/height 必须为有限正数。可写端传入新的 MainView originSize 时，会重置并同步主视图参考尺寸与相机尺寸约定；同房间应约定一致的尺寸。它不是单纯改变本端 CSS 宽高。

Slide 与 Presentation 参考尺寸

TypeScript

const slide: WindowAppParam = {
  kind: 'Slide', options: { scenePath: '/slide/lesson-1', title: '动态课件' },
  attributes: { taskId: taskId, url: url }, originSize: { width: 1280, height: 720 }
};
const slideId = await controller.addApp(slide);
const presentation: WindowAppParam = {
  kind: 'Presentation', options: { scenePath: '/presentation/lesson-1', scenes: scenes,
    title: '静态课件' }, originSize: { width: 1280, height: 720 }
};
const presentationId = await controller.addApp(presentation);

课件的 originSize 最终写入 attributes.originSize。Slide 仍使用自己的动态转码资源，Presentation 使用图片页 scenes；参考尺寸不会把静态图片变成动态 PPT。已有课件不会因为新建参数改变而自动批量更新。

恢复与读取

TypeScript

controller.fitOriginSizeAndCamera();

fitOriginSizeAndCamera 恢复 MainView 的参考尺寸和初始相机，不改变其他 App 的 originSize。页面倍率与翻页控制见统一页面控制：scale=1 为适配大小，可能与相机的绝对 scale 不同。pageScaleRange 限制相对适配倍率，未提供的边界不新增业务限制。