@netless/slide 0.3.10 → 0.4.2

package/README.md

@@ -358,6 +358,63 @@ clearSlideCache(): void;
 static clearLocalCache(): void;
 ```
 
+### 资源代理
+
+**注意: `@netless/slide@0.4.0` 版本才开始支持。**
+
+从 `@netless/slide@0.4.0` 开始, 你可以在创建 Slide 对象时提供一个 loaderDelegate 对象, 从而代理 Slide 内部所有远程资源, 进而可以实现
+资源重定向, 资源鉴权等需求.
+
+loaderDelegate 属性需符合 `ILoaderDelegate` 接口, 需要注意对于媒体资源, 并不能直接返回资源内容, 只能同步的返回重定向后的资源地址.
+
+```typescript
+export interface ILoaderDelegate {
+    /**
+     * 加载 json 资源, 需返回 json 文本
+     * @param url 原始资源地址
+     */
+    loadJson(url: string): Promise<string>;
+    /**
+     * 加载图片资源, 需返回 Blob 对象
+     * @param url 原始资源地址
+     */
+    loadImage(url: string): Promise<Blob>;
+    /**
+     * 媒体文件重定向, mp3 和 mp4 资源会调用这个代理函数, 需返回重定向后的 url
+     * @param url 原始资源地址
+     */
+    redirectMedia(url: string): string;
+}
+```
+
+一个什么也不干的 loaderDelegate 如下所示, 但是你可以对传入的 url 进行加工:
+
+```typescript
+import { Slide, ILoaderDelegate } from "@netless/slide"
+
+const delegate: ILoaderDelegate = {
+    loadJson(url: string): Promise<string> {
+        return fetch(url).then(res => {
+            return res.text();
+        });
+    },
+    loadImage(url: string): Promise<Blob> {
+        return fetch(url).then(res => {
+            return res.blob();
+        });
+    },
+    redirectMedia(url: string): string {
+        return url;
+    }
+}
+
+const slide = new Slide({
+    /// ... 其他初始化配置
+    loaderDelegate: delegate,
+})
+```
+
+
 ## [示例及具体文档参考](https://github.com/netless-io/netless-slide-demo)
 
 ## changelog
@@ -503,3 +560,14 @@ static clearLocalCache(): void;
 #### 0.3.10
 * 新增本地日志下载功能
 * 修复加载状态不一致导致无法下一步的问题
+
+#### 0.4.0
+* 新增资源代理功能
+
+#### 0.4.1
+* 新增导航代理功能
+
+#### 0.4.2
+* 修复事件穿透问题
+* 修复音频重复播放问题
+* 修复翻页后触发器动画被重置的问题

package/lib/Slide.d.ts

@@ -1,5 +1,6 @@
-import { SlideError } from "@netless/ppt-player";
+import { SlideError, ILoaderDelegate } from "@netless/ppt-player";
 export { ErrorType } from "@netless/ppt-player";
+export type { ILoaderDelegate } from "@netless/ppt-player";
 export interface RtcAudio {
     /**
      * 开始播放音频.
@@ -114,6 +115,9 @@ export interface ISlideRenderOptions {
     /** 播放切页动画时候的背景颜色, 接受 css 颜色字符串或者 16进制颜色值("#ffffff",0xffffff) */
     transactionBgColor?: string | number;
 }
+export interface INavigatorDelegate {
+    gotoPage(index: number): void;
+}
 export interface ISlideConfig {
     /** canvas 挂载点 */
     anchor: HTMLDivElement;
@@ -158,6 +162,14 @@ export interface ISlideConfig {
      * 资源加载超时时间, 默认 15 秒
      */
     resourceTimeout?: number;
+    /**
+     * 远程资源代理, 详细使用参考 README
+     */
+    loaderDelegate?: ILoaderDelegate;
+    /**
+     * ppt 页码导航代理, 添加此属性后, ppt 内部动作引起的页码变换, 全部走代理逻辑.
+     */
+    navigatorDelegate?: INavigatorDelegate;
 }
 interface MediaState {
     type: "pause" | "play";