🌎 一款基于Cesium的三维角色控制器插件

演示地址

http://devmodels.oss-cn-shenzhen.aliyuncs.com/devtest/liubofang/CesiumRoleController/index.html

下载运行此示例代码

   yarn install  // 安装依赖
   yarn run serve  // 运行示例代码
   yarn run build  // 编译打包示例代码

快速上手

import CesiumRoleController from 'cesium-role-controller'

/*
import * as Cesium from 'cesium'
let viewer = Cesium.viewer({...})
*/

let controller = new CesiumRoleController(Cesium, viewer)
controller.init({
  position: [106.306177, 36.030691],
  url: 'http://devmodels.oss-cn-shenzhen.aliyuncs.com/devtest/liubofang/glb/foreigner_cesium.glb',
  animation: 'run',
})

API 文档

options

名称	说明	类型	可选值	默认值	是否必选
url	模型地址	string	-	-	是
position	初始经纬度坐标	array	-	-	是
animation	模型动画名称	string	-	-	否
speed	运动速度	number	-	1	否
pitch	相机看向模型的俯仰角度	number	0~-90	-25	否
lockViewLevel	相机看向模型的限制级别，等级由低到高，1 为自由视角，3 为全限制	number	1~3	3	否
range	相机看向模型的视角范围	number	0~99999	4	否

method

名称	说明	参数	参数类型	返回值	使用方法
init	初始化	options	object	void	controller.init({...})
destroy	销毁	-	-	void	controller.destroy()

注意事项

1. 本插件基于 Cesium 104+以上版本进行开发，如需兼容早期版本，可自行修改源码
2. 通过键盘 W/S/A/D 控制人物移动和鼠标控制相机视角
3. 当在启用地形的地图下时 可以把 speed 和 range 设置大一些 如 speed:10 range:1000

版权说明

1. cesium-role-controller 插件由liubf自主研发，拥有所有权利。
2. 任何个人或组织可以在遵守相关要求下可以免费无限制使用。

版本日志

1.0.0 2023/06/07

1. 添加初始化配置参数
2. 添加初始化方法

1.0.1 2023/06/08

1. 修复配置文件参数拼写错误 参数 lookViewLevel 修改为 lockViewLevel

1.0.2 2023/06/08

1. 修复自由视角下相机飘的问题

1.0.3 2023/06/08

1. 修复自由视角下多个按键按下相机飘的问题

1.0.4 2023/06/09

1. 优化一些局部问题

示例视频

贴合地形视频

贴合 3dtiles 视频