基于 WebSocket 的 PPT 远程控制器简单实现

一、背景

这个 idea 是在大学毕设答辩前萌发的,当时正学习实践前端知识,接触到了一个通过前端代码来编写并运行在浏览器中的 PPT 项目 revealjs

看完后当时的内心独白:

毕设答辩的 PPT 可以用这个来写,
学 (biāo)
以 (xīn)
致 (lì)
用 (yì)
,不枉我学过前端技术;

有了 PPT 的页面,那翻页还需要鼠标一下一下点击?有没有更好的替代翻页效果的方式

别人 PPT 演说都还需要配置无线翻页笔,有什么方法可以实现类似的操作呢?

我可不可以使用手机远程控制 通过 revealjs 编写的浏览器端的 PPT 页面呢?

查阅一些资料后,了解了 WebSocket 全双工通信协议[1],现代浏览器支持;

由此想到,可以写一个有上下左右控制的页面,连接一个 WebSocket 服务,然后点击上下左右后下发「指令」到 WebSocket 服务,然后 PPT 页面也连接此 WebSocket 服务 ,最后 WebSocket 服务 转发 「指令」 给 PPT 页面,从而做出翻页操作。

NICE!🍻

二、目标

基于 WebSocket 和 reveal.js,实现通过手机终端能控制 使用 reveal.js 实现的 PPT 网页端,进行远程上下左右翻页的操作。

目前实现 一个控制器端控制一个 PPT 网页端

三、基本原理

PPT 网页端和控制器端同时连接 WebSocket Service,由控制器端发送翻页操作指令(上下左右)到 WebSocket Service,然后 WebSocket Service 通知 PPT 网页端,PPT网页端执行翻页操作指令。

基本原理

四、实现效果

实现效果预览

将上图中由浏览器打开的控制端页面换为连接同一局域网的手机浏览器打开,就实现了最初的想法。

五、功能实现

源码地址: github.com/wenlong-date/ppt

1. 使用 workerman 提供 WebSocket 服务

PPT 网页端和控制器端连接 WebSocket Service 后会简单的「自报家门」,初始化 PPT 网页端的 connection 和控制器的 connection,

file: server.php

// ... 
(new PptSocketServer())->run();

class PptSocketServer
{
    const CONNECTION_TYPE_PPT = 'connection_ppt';
    const CONNECTION_TYPE_CONTROLLER = 'connection_controller';

    protected $worker;
    protected $globalUid = 0;
    protected $globalPptConnection;
    protected $globalControllerConnection;

    public function __construct(int $port = 2346)
    {
        $this->initWorker($port);
    }

    public function run()
    {
        Worker::runAll();
    }

    protected function initWorker(int $port)
    {
        $this->worker            = new Worker("websocket://0.0.0.0:" . $port);
        $this->worker->count     = 1;
        $this->worker->onConnect = [$this, 'handleConnection'];
        $this->worker->onMessage = [$this, 'handleMessage'];
        $this->worker->onClose   = [$this, 'handleClose'];

    }

    // 简单记录连接的 id 信息
    public function handleConnection($connection)
    {
        $connection->uid = ++$this->globalUid;
    }

    public function handleMessage($connection, $data)
    {
        // 初始化 PPT 网页端的 connection
        if ($this->setPptConnectionIfNull($connection, $data)) {
            Log::info('ppt online');
            return;
        }
        // 初始化 控制端页面的 connection
        if ($this->setControllerConnectionIfNull($connection, $data)) {
            Log::info('controller online');
            return;
        }

        // ...
    }

    public function handleClose($connection)
    {
        // 判断并销毁 PPT 网页端或者控制端页面的 connection
        $this->destructConnection($connection);

        Log::info($connection->uid . ' offline by close websocket');
    }

    protected function destructConnection($connection)
    {
        if (isset($connection->type) && $connection->type === self::CONNECTION_TYPE_PPT) {
            $this->globalPptConnection = null;
            Log::info('ppt offline');
            return true;
        }

        if (isset($connection->type) && $connection->type === self::CONNECTION_TYPE_CONTROLLER) {
            $this->globalControllerConnection = null;
            Log::info('controller offline');
            return true;
        }

        return true;
    }

    /**
     * 根据命令判断和初始化 PPT 网页端的 connection
     *
     * @param $connection
     * @param $data
     * @return bool
     */
    protected function setPptConnectionIfNull($connection, $data)
    {
        if (!is_null($this->globalPptConnection)) return false;
        if (!$this->requestConnectionIsPpt($data)) return false;

        $connection->type          = self::CONNECTION_TYPE_PPT;
        $this->globalPptConnection = $connection;
        return true;
    }

    /**
     * 根据命令判断和初始化控制端页面的 connection
     *
     * @param $connection
     * @param $data
     * @return bool
     */
    protected function setControllerConnectionIfNull($connection, $data)
    {
        if (!is_null($this->globalControllerConnection)) return false;
        if (!$this->requestConnectionIsController($data)) return false;

        $connection->type                 = self::CONNECTION_TYPE_CONTROLLER;
        $this->globalControllerConnection = $connection;
        return true;
    }

    public function requestConnectionIsPpt($data)
    {
        return $data === 'i am ppt';
    }

    public function requestConnectionIsController($data)
    {
        return $data === 'i am controller';
    }

}

2. 控制端页面发送「指令」给 WebSocket Service

file: /web/controller/index.html

// ...

var ws = new WebSocket('ws://' + location.hostname + ":2346");
ws.onopen = function () {
    ws.send('i am controller');
};
ws.onmessage = function (e) {
    console.log('controller get message from server: ' + e.data);
};

var $ = function (dom) {
    return document.getElementById(dom);
}
$('up').onclick = function () {
    sendCommand('up');
}
$('right').onclick = function () {
    sendCommand('right');
}
$('down').onclick = function () {
    sendCommand('down');
}
$('left').onclick = function () {
    sendCommand('left');
}

function sendCommand(status) {
    ws.send(status);
}

// ...

3. WebSocket Service 发送「指令」给 PPT 网页端

发送「指令」前 判断 PPT 网页端是否在线,以及只允许一个控制端页面进行「指令」的下发

file: /web/controller/control.js

// ...

class PptSocketServer
{
    // ...

    public function handleMessage($connection, $data)
    {
        // ...

        if (is_null($this->globalPptConnection)) {
            Log::info('ppt offline; cant control');
            return;
        }

        // 目前只允许一个控制器发送指令。
        if (!is_null($this->globalControllerConnection)
            && $connection->uid !== $this->globalControllerConnection->uid
        ) {
            Log::info('sorry, you are not correct controller ' . $connection->uid);
            return;
        }
        // 转发控制端「指令」到 PPT 网页端
        $this->globalPptConnection->send($data);
    }
    // ...

}

4. PPT 网页端执行翻页「指令」

file: server.php

// ...

var ws = new WebSocket('ws://' + location.hostname + ":2346");
ws.onopen = function () {
    ws.send('i am ppt');
};
ws.onmessage = function (e) {
    console.log('ppt get message from server: ' + e.data);
    switch (e.data) {
        case 'up':
            Reveal.up();
            break;
        case 'right':
            Reveal.right();
            break;
        case 'down':
            Reveal.down();
            break;
        case 'left':
            Reveal.left();
            break;
        default:
            console.log('unSupport command : ' . e.data)
    }
};

// ...

六、本地运行

注意: 如果要演示自己的 revealjs PPT 则需要先在 PPT 的首页 html 文件尾部中引入 control.js

 <script src="/controller/control.js"></script>

1. git clone github.com/wenlong-date/ppt.git && composer install
2. 将 web/ppt 目录下的文件 替换为你自己的 reveal.js PPT 相关的前端文件 (默认有demo演示用的 PPT)
3. 执行 php server.php start [-d] (-d 后台运行)
4. 另一个窗口执行 cd web && php -S 0.0.0.0:80 (或者使用 Nginx 提供 Web 服务)
5. 网页端打开地址 http://{yourip}/ppt/
6. 同一局域网连接的手机浏览器打开地址为 http://{yourip}/ppt/ (会自动跳转到控制端页面)即可。(如果公网 IP 地址就没有局域网络限制了)

七、Docker Image && Docker run

仓库中已经有 Dockerfile 文件,可以手动 build 。

1. 同时也可以使用 docker pull wenlongdotdate/websocketppt 获取镜像
2. 本地运行 docker run -it -p 2346:2346 -p 80:80 -d wenlongdotdate/websocketppt (可以选择自己的 PPT 前端文件目录 挂载 到容器的 /var/www/html/web/ppt 目录下)
3. 网页端打开 http://{yourip}/ppt/
4. 同一局域网连接的手机浏览器打开地址为 http://{yourip}/ppt/ (会自动跳转到控制端页面)即可。(如果公网 IP 地址就没有局域网络限制了)

八、更多想法

目前只是 一对一 的控制一个 PPT,功能很简陋。

可以考虑为不同用户提供一个针对 reveal.js 开发的网页 PPT 提供一个 WebSocket 网页控制端服务。

每个用户在后台可以创建一个 控制器资源, 控制器将会生成一个唯一的通信频道和 PPT 可以引入的 JavaScript 文件(连接 WebSocket 服务并通信)。

这样 不同用户 可以通过手机浏览器控制自己基于 Reveal.js 开发的网页 PPT 需要下面三步:

1. 创建 控制器 资源
2. reveal.js 的 PPT 引入相应 JavaScript 文件
3. 手机浏览器 扫描 当前控制器资源 控制器二维码,打开控制端页面进行远程控制

面向多用户的服务

参考资料

本作品采用《CC 协议》,转载必须注明作者和本文链接
《L03 构架 API 服务器》
你将学到如 RESTFul 设计风格、PostMan 的使用、OAuth 流程,JWT 概念及使用 和 API 开发相关的进阶知识。
《L02 从零构建论坛系统》
以构建论坛项目 LaraBBS 为线索,展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。
讨论数量: 4

有点多此一举了,捕捉到动作直接前端就操作完了,还整个服务端来了。。。

2年前 评论

@lidongyoo 我想实现的是 通过手机浏览器远程打开控制页下发翻页操作命令 给 用 PC 浏览器打开的 PPT 页面, 让 PPT 页面实现翻页效果。

你说的「捕捉到动作直接前端就操作完了」,有点没有理解 :see_no_evil: ,是指在 PPT 页面上捕获上下左右滑动的操作,然后促使 PPT 页面执行翻页效果吗?

2年前 评论

@LongWen ~~这样啊,两个设备通信确实需要服务端。

可以看看 WebRTC ,也不用搭服务端了(使用公开 stun 服务器~)

2年前 评论

@lidongyoo 新思路!NICE! :beers:

2年前 评论

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容,与人为善,比聪明更重要!