# 7\_6-核心common-PPT

* [1 功能概述](#1-功能概述)
* [2 MVP模式](#2-mvp模式)
  * [2.1 Presenter实现逻辑](#21-presenter实现逻辑)
    * [2.1.1 PLVLiveFloatingPresenter](#211-plvlivefloatingpresenter)
    * [2.2.2 PLVPPTPresenter](#222-plvpptpresenter)
* [3 SDK核心类介绍](#3-sdk核心类介绍)
  * [3.1 用PolyvSocketWrapper收发服务端PPT消息](#31-用polyvsocketwrapper收发服务端ppt消息)
  * [3.2 PPT使用的WebView](#32-ppt使用的webview)

#### 1 功能概述

common模块的ppt是使用mvp模式实现的，将PPT的一些UI无关的底层逻辑封装在了这个模块。

#### 2 MVP模式

PPT模块包含了两个MVP的接口，分别是悬浮窗和PPT：

悬浮窗

```java
/**
 * date: 2020/9/16
 * author: HWilliamgo
 * description: 悬浮窗业务MVP
 */
public interface IPLVLiveFloatingContract {

    /**
     * 悬浮窗View
     */
    interface IPLVLiveFloatingView {

        /**
         * 设置讲师信息
         *
         * @param nick   讲师昵称
         * @param picUrl 讲师图片Url
         */
        void updateTeacherInfo(String nick, String picUrl);
    }

    /**
     * 悬浮窗业务Presenter
     */
    interface IPLVLiveFloatingPresenter {
        /**
         * 初始化
         */
        void init(IPLVLiveFloatingView view);

        /**
         * 销毁
         */
        void destroy();
    }
}
```

PPTView

```java
/**
 * date: 2020/9/16
 * author: HWilliamgo
 * description: PPT业务MVP
 */
public interface IPLVPPTContract {
    /**
     * PPTView
     */
    interface IPLVPPTView {

        /**
         * 发送消息到webView
         *
         * @param msg 消息
         */
        void sendMsgToWebView(String msg);

        /**
         * 发送消息到webView
         *
         * @param msg   消息
         * @param event 事件
         */
        void sendMsgToWebView(String msg, String event);

        /**
         * 隐藏加载中图片
         * 直播时，则聊天室登录后，收到PPT控制消息时，隐藏加载中图片。
         * 回放时，在收到PPT的prepare回调后，异常加载中图片。
         */
        void hideLoading();

    }

    /**
     * PPT Presenter
     */
    interface IPLVPPTPresenter {
        /**
         * 初始化
         *
         * @param view view
         */
        void init(IPLVPPTView view);

        /**
         * 移除消息延迟时间
         */
        void removeMsgDelayTime();

        /**
         * 恢复消息延迟时间
         */
        void recoverMsgDelayTime();

        /**
         * 发送画笔消息
         */
        void sendPPTBrushMsg(String msg);

        /**
         * 销毁
         */
        void destroy();
    }
}
```

**2.1 Presenter实现逻辑**

**2.1.1 PLVLiveFloatingPresenter**

悬浮窗的Presenter主要的逻辑是，用socket管理器监听了聊天室发出的讲师信息事件，并将数据解析后更新到View接口：

```java
PolyvSocketWrapper.getInstance().getSocketObserver().addOnMessageListener(onMessageListener = new PLVSocketMessageObserver.OnMessageListener() {
            @Override
            public void onMessage(String listenEvent, String event, String message) {
                if (PLVEventConstant.Class.O_TEACHER_INFO.equals(event)) {
                    PLVTeacherInfoEvent teacherInfoEvent = PLVEventHelper.toMessageEventModel(message, PLVTeacherInfoEvent.class);
                    if (teacherInfoEvent != null) {
                        String teacherNick = teacherInfoEvent.getData().getNick();
                        String picUrl = teacherInfoEvent.getData().getPic();
                        if (view != null) {
                            view.updateTeacherInfo(teacherNick, picUrl);
                        }
                    }
                }
            }
        });
```

**2.2.2 PLVPPTPresenter**

PLVPPTPresenter中实现了对PPT事件的收发操作。

1. 监听server发来的PPT消息，解析后将消息发送到View层，由View层的webView进行处理：

   ```java
   PolyvSocketWrapper.getInstance().getSocketObserver().addOnMessageListener(
           onMessageListener = new PLVSocketMessageObserver.OnMessageListener() {
               @Override
               public void onMessage(String listenEvent, String event, String message) {
                   if (PLVEventConstant.Ppt.ON_SLICE_START_EVENT.equals(event) ||
                           PLVEventConstant.Ppt.ON_SLICE_DRAW_EVENT.equals(event) ||
                           PLVEventConstant.Ppt.ON_ASSISTANT_CONTROL.equals(event) ||
                           PLVEventConstant.Ppt.ON_SLICE_OPEN_EVENT.equals(event) ||
                           PLVEventConstant.Ppt.ON_SLICE_ID_EVENT.equals(event)) {
                       //...
                   } else if (PLVEventConstant.MESSAGE_EVENT_LOGIN.equals(event)) {
                       //发送login事件到ppt
                       //...
                   }
               }
           }
   );
   ```
2. 当用户操作PPT画笔时，要将画笔数据发送到server（该功能暂未实现）

   ```java
   //发送画笔事件
   PolyvSocketWrapper.getInstance().emit(PLVEventConstant.MESSAGE_EVENT, message);
   ```

#### 3 SDK核心类介绍

**3.1 用PolyvSocketWrapper收发服务端PPT消息**

common模块的PPT用到的SDK类是`PolyvSocketWrapper`,利用该类，既可以监听服务端老师发送的PPT事件，也可以主动发送PPT数据到服务端。

具体可以参考PLVLiveFloatingPresenter和PLVPPTPresenter中对该类的使用。

**3.2 PPT使用的WebView**

PPT使用的是SDK提供的`PolyvPPTWebView`类进行渲染的，对该类的使用均封装在了Scene模块的`PLVLCPPTView`类中，只是调用逻辑在presenter。

他有3类API：

1. 通用对外API

   ```java
   //注册被js调用的方法
   public void registerHandler();
   //加载webView
   public void loadWeb();
   //发送消息到JS
   public void callMessage(String event, String message);

   ```
2. 直播对外API

   ```java
   //发送消息到JS
   public void callUpdateWebView(String messages);
   ```
3. 回放对外API

   ```java
   //发送播放开始
   public void callStart(String messages);
   //发送播放暂停
   public void callPause(String messages);
   //发送seek
   public void callSeek(String messages);
   //发送PPT数据
   public void callPPTParams(String messages);
   ```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://polyv.gitbook.io/document/docs/live/android/76-he-xin-commonppt.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.