jarvis-controller v0.2.5

Jarvis Controller

Jarvis 控制端, 查看演示项目代码

安装

npm install jarvis-controller

使用

import JarvisController from 'jarvis-controller'

const controller = new JarvisController({
  url: 'ws:127.0.0.1:3000',
  secrets: '5r9b4vto246doa9hwk55rr',
  id: 'ipad-1'
})

// 等待连接服务器
await controller.connect()

// 发送操作指令
controller.send('move', '10px')

参数说明：

发送事件

你可以使用 send 方法发送事件：

controller.send(command, args)

监听事件

你可以使用 on 方法监听系统事件：

controller.on('open', e => {
  console.log('已经连接到控制服务器!')
})

目前支持的事件如下：

插件

目前仅支持一种插件

TouchPad

此插件为页面提供了一个移动端触控区域, 在控制端的触控区域内, 进行滑动/缩放等, 将会发送对应指令给受控端

import JarvisController, { TouchPad } from 'jarvis-controller'

const touchPadPlugin = new TouchPad({
  selector: '#touchPad', // 触控区域的选择器
  throttle: 100
})

const controller = new JarvisController({
  url: `ws:127.0.0.1:3000`,
  secrets: '5r9b4vto246doa9hwk55rr',
  id: 'ipad-1',
  plugins: [touchPadPlugin]
})

controller.connect()

向受控端发送的事件及参数详情:

singletap | doubletap

pan

rotate

eventType

自定义插件

我们允许自定义控制端插件, 参考写法如下:

// 自定义插件 HelloWord
class HelloWord {
  constructor({ selector }) {
    this.container = document.querySelector(selector)
  }
  // init方法会接收controller, 用来发送指令
  init(controller): void {
    this.controller = controller
    this.container.addEventListener('click', () => {
      this.controller.send('hello-word')
    })
  }
}
const controller = new JarvisController({
  url: `ws:${location.hostname}:3000`,
  secrets: '5r9b4vto246doa9hwk55rr',
  id: 'ipad-1',
  plugins: [helloWorld]
})

controller.connect()

心跳检测

服务端每隔 10s 会向控制端发送 ping 事件, 控制端返回 pong, 若检测到断开连接, 则每隔 10s 尝试重连一次, 连续三次重连失败, 控制端会发送 reconnect-fail 事件给页面, 后续逻辑需要监听事件自行处理

controller.on('reconnect-fail', () => {
  console.log('controller跟server断开连接, 并尝试重连失败')
})

其他

服务端和受控端的使用方式, 可查阅下方文档

Jarvis 服务端地址

Jarvis 受控端地址

Jarvis 演示项目代码地址