Cloud V5.2
全新的Cloud高渲染云服务平台,拥有单机和集群两种运行方式。以及全新的设计及用户界面。
云渲染对终端的要求
云渲染对终端设备及浏览器有一定的要求。
安卓设备
云渲染仅支持Chrome浏览器进行浏览,不支持手机自带浏览器和其他浏览器。对于Chrome浏览器也是有要求的,如果手机的CPU是高通、英特尔、三星之外的厂家生产的CPU,需要chrome的版本至少是81。
iOS设备
iOS设备支持自带的Safari浏览器和Chrome浏览器,不支持其他浏览器。
Windows
支持Chrome和Firefox,以及基于Chrome内核(Blink引擎)的浏览器。推荐使用Chrome浏览器,需要chrome的版本至少是81。
网络
电脑必须连接网线。
互联网连接非必须。
Cloud框架结构
基础框架
全新的Cloud包含了CloudMaster以及NodeService(暂名)两个程序。CloudMaster为主控机管理平台;而NodeService则为节点机服务程序。如果是传统的单机服务,则只运行安装CloudMaster即可。
集群模式
用户通过1台主控电脑,可以对若干节点机进行管理。
注:主控机可安装远程访问的程序对节点机辅助控制。
Cloud安装
除了包含CloudMaster和NodeService的传统的“AirCity Cloud.ISO”外,新增了仅包含CloudMaster的安装包。
主控机在不运行实例渲染的情况下,仅安装CloudMaster即可。如果主控机也需要进行实例渲染,则需要安装AirCity Cloud.ISO。
安装Cloud
打开AirCity Cloud.ISO镜像文件,弹出内容文件夹。、
运行“Setup.exe”程序,在短暂的准备进度后,进入安装欢迎界面。
选择“下一步”,进入“许可证协议”页面。
请仔细阅读《最终用户许可协议》。如果同意协议,请选择“是”。若不同意,请选择“否”结束安装。
选择安装路径。要安装到默认目录,请直接选择“下一步”。要安装到其他文件夹,请选择“浏览”,然后选择其他文件夹。
选择“安装”,以开始安装。
安装过程需要若干分钟,请耐心等待。
当安装完毕,出现完成窗口。单击“完成”,完成Cloud软件的安装。
安装完成后,在电脑的“开始”菜单和桌面增加CloudMaster和NodeService的快捷方式。
安装CloudMaster
打开AirCity CloudMaster.exe,在短暂的准备进度后,进入安装欢迎界面。
选择“下一步”,进入“许可证协议”页面。
请仔细阅读《最终用户许可协议》。如果同意协议,请选择“是”。若不同意,请选择“否”结束安装。
选择安装路径。要安装到默认目录,请直接选择“下一步”。要安装到其他文件夹,请选择“浏览”,然后选择其他文件夹。
选择“安装”,以开始安装。
安装过程需要若干分钟,请耐心等待。
当安装完毕,出现完成窗口。单击“完成”,完成CloudMaster软件的安装。
安装完成后,在电脑的“开始”菜单和桌面增加CloudMaster的快捷方式。
CloudMaster使用说明
首先需要运行主控机的CloudMaster并设置相关服务后,才可以和节点机进行通讯。
界面基本说明
CloudMaster可视化操作界面。
注:图片仅作示意,请以实际界面为准。
快捷工具栏
快速查看用户手册等链接。
快捷键说明
查看CloudMaster的快捷键说明。
查看用户手册
快速访问Cloud在线用户手册。Cloud在线用户手册
了解二次开发
查看二次开发的相关详细文档。
观看视频教程
观看Cloud V5.0的使用教程视频、
SDK
打开二次开发文件夹,内含帮助页面、样例工程、示例代码等内容。
日志目录
打开本地日志文件夹。
启用/停止服务
当服务设置、工程、渲染节点和实例都设置好后,可以对服务进行启动或关停等相关操作。
调试:
点击“调试”按钮,即可启动调试模式。调试模式会弹出多个命令行窗口和三维场景窗口。便于开发调试。
启动:
正常在后台启动Cloud云服务。
停止
结束所启动的所有实例进程。包括AirCityCloud.exe、SignallingWebServer、HttpServer、MatchServer等进程。
提示: 当服务启动后,CloudMasters主界面右上角的指示灯会亮起并闪烁。
功能页面
选择不同的功能,切换相应的页面。
状态信息
显示当前的空闲实例、服务IP以及版本信息等内容。
服务指示灯
显示服务的状态。
运行日志
显示当前操作的日志内容。完整日志信息请前往运行日志
服务设置
常规设置
关于Cloud的常规设置选项。
启动后自动后台运行
启用后,程序在运行后自动启动服务。
退出时关闭所有进程
启用后,程序退出时会自动关闭所启动的所有实例及服务。
启用进程守护
启用后,Cloud会监视每个实例(Cloud进程和信令服务进程)的运行状况,一旦发现意外退出或者没有响应,则会自动重启。
服务地址
关于Cloud主控和节点相关的通讯服务设置选项。开启端口映射后,其他设置也会展开相应的设置项。
信令服务设置后必须启动服务后才可以和节点机进行通讯。
IP地址或域名
主控服务器的IP地址或域名。也可以自定义。IP地址主要用在链接节点机和使用HTTP服义。
启用端口映射
通过端口映射功能,将内网IP和端口转翻译为公网的IP和端口。勾选后,才可以设置映射的端口和IP。
使用独立的端口
默认情况下云服务仅需1个端口号。
如果配置了HTTPS,在以下情况需要使用3个独立的端口号:
- 不是有效的证书
- 不是通过域名访问
渲染节点所在机器无法链接互联网
启用后将会显示出HTTP、Manager和Streamer端口。
中继服务
通过中继服务,Cloud服务可实现互联网的访问及支持。
监听IP
网络协议地址。
端口
网络协议端口。
查看用户信息
中继服务每次在启动时,会随机生成用户名和密码。启动服务后,悬停即可查看到相应的内容,并可以单击复制。
此功能用于Cloud开发调试测试。
服务选项
关于云服务的更多进阶设置。
自动断开
自动断开长时间没有交互操作的用户
当用户长时间没有任何交互操作时,Cloud将会自动断开其链接以供其他用户使用。
时长(分钟)
断开服务链接的时长,单位为分钟。取值范围为1~600分钟。
HTTPS配置
关于HTTPS的高级参数设置。
使用安全传输协议(HTTPS)
开启使用安全传输协议。
证书文件
选择证书文件,支持多种格式的证书,如DER、CER、CRT、PEM和PFX等。
私钥文件
选择私钥文件,如果证书文件中包含私钥(如PEM、PFC、P12),则无需选择。
密码
如果证书有密码保护,请输入证书密码。
服务高级参数
关于中继服务的高级参数设置。
强制使用TURN服务中继视频流
强制使用TRUN服务中继视频流
使用TCP代理UDP作为中继传输协议
强使用TCP代理UDP作为中继传输协议,无特殊需求不建议设置。
“为什么网络服务一定要用UDP端口,而不能只用TCP端口?” 关于这个问题,请阅读🔗《为什么您的web RTC绘画应该更细化UDP而不是TCP》
实例管理服务用户权限
如果实例管理功能只是内网部署,一般情况下不需要启用;如果实例管理服务需要公网访问,配置用户密码可提高安全性,防止用户随意调用实例管理功能。
实例管理服务需要用户权限 开启实例管理服务的相关用户权限。
用户名 实例管理服务的登录用户名。
密码 实例管理服务的登录密码。
启动HTTP服务
启动HTTP服务可以在不启动主服务的情况下,实现切片服务、文件资源共享、查看样例集锦等功能。
注:虽然启动HTTP服务后可以查看API示例、样例集锦等内容,但相应的视频流是无法显示的。
HTTP服务通过“停止”结束服务。
调试选项
启用日志文件
启用后,程序运行时会记录相应的记录。
日志等级
设置需要记录的级别。分为Debug、Info、Warn、Error、Fatal级别。日志等级越低,需要记录的内容就会越多。请根据实际需求选择所需要的等级。
日志设置对以下程序或进程有效:
- CloudMaster
- CloudServer
- RelayServer
- NodeService
- CloudRenderer
日志等级说明:
- Debug 调试信息
- Info 一般信息
- Warn 可能出现潜在错误的警告信息
- Error 错误信息
- Fatal 导致程序终止运行的致命错误
工程列表
云服务工程列表。可以添加、修改、删除和同步工程文件。
ACP工程文件可以网络共享工程,也可以存储在节点机中。网络共享工程,需要保证所有的节点机都有权限可以访问。当有多个节点机时,所有的本地工程都需要保证存储路径的完全一致。
Cloud V5.1支持在主控和节点设备之间同步工程。
在节点设备中,NodeService会自动选择一个存储空间最大的磁盘,作为同步工程存储目录。
添加
添加一个工程文件。
删除
将选中的工程文件从工程列表中删除。
同步工程列表
将工程列表中的工程文件同步到节点设备上。 Cloud会自动在节点设备上最大的磁盘上创建一个目录存放工程文件。目录为“~:\FreeCloudData\Projects”
同步时会终止所有渲染节点上正在运行的实例。 同步目录无法手动更改。
同步时删除列表中不存在的工程文件
在同步的过程中,将节点设备上存在但是已不在列表中的工程文件删除。
使用此工程测试云渲染
当选择一个工程时,可以“使用该工程测试云渲染”
说明:
- 每个工程的“工程索引”即为该工程的“PID”参数。
- 工程文件不支持同名,就算路径不相同。
渲染节点
节点机列表。所有链接到主控机的节点机都在此显示。只有在启动服务后才能看到所有的渲染节点。
显示实例列表
查看当前选择的渲染节点中包含的所有实例。点击后会跳转到“实例列表”页面。
修改实例数
根据当前渲染节点主机的显卡数量,在可选范围内设置实例的数量。
获取节点日志
获取各个节点设备的日志文件。
实例列表
Cloud提供多实例功能,可以实现实例的自动化启动、实例分配、权限管理、实时状态获取等功能。
操作
对当前选择的实例进行相关操作。也可以通过右键菜单进行操作。
设置参数
实例参数设置中包含了基础参数及高级参数。
关于“设置参数”中的详细参数设置,请查看章节“实力参数设置”
取消锁定
取消锁定当前选择的实例的工程。
启动
启动当前选择的实例。
停止
停止当前选择的实例。
复制实例ID
复制当前选择的实例的ID。以便于二次开发和访问。
复制实例详细信息
复制当前所选的实例的详细信息,包含ID、PID、当前工程、分辨率等信息。
断开客户端链接
断开当前实例连接的客户端。
TEST:int.html - 接口测试
选择当前实例,并以int.html的接口测试页面形式运行。并且可以选择具体的工程。
TEST:player - 视频流测试
选择当前实例,并以player视频流测试的形式运行。并且可以选择具体的工程。
TEST:main - 综合测试
选择当前实例,并以main综合测试页面的形式运行。并且可以选择具体的工程。
实例设置参数
实例参数设置中包含了关于实例的基础参数及高级参数。
实例ID
实例的ID,不可编辑。
显卡索引
当前实例所用的显卡的索引号。“-1”为自动识别。当开启“手动分配显卡索引”后,可以手动输入显卡的索引编号。
工程
指定该实例的默认工程。
锁定工程
开启后该实例只能试用当前选择的工程。
被锁定的工程有以下特征:
- 后台静默启动,可以瞬时访问服务;
- 不能动态设置参数;
- 不参与动他资源分配,必须指定实例ID才能访问。
分辨率
设置云服务视频流的分辨率。可自定义参数,也可从HD、FHD、2K、4K中选择一个。
三维自适应客户端分辨率
勾选后云服务视频流会自动适配客户访问端的分辨率。
限制最大分辨率
限制云服务视频流的最大分辨率。
模式
云服务视频流的模式选择,分为高画质、均衡、流畅和自定义。每种模式需要的带宽也不同。
高画质 以高画质为优先的模式。
均衡 均衡画质和帧数的模式。
流畅 以高帧数为优先的模式。
自定义 用户根据需求自定义的模式。
提示 双击任意一个模式,即可快速进入详细设置页面。
高级参数
实例参数设置中的高级参数。
连接设置
限制一个实例只能由一个客户端连接 开启后一个实例只能由一个客户端连接。
API增加对WebSocket的支持 开启后API增加对WebSocket的支持。
CloudMaster默认调用WebRTC,不需要额外的接口。开启此选项后,可以同时支持WebSocket调用方式。
WebSocket服务端口 WebSocket的服务端口。可以选择“获取”。
渲染设置
帧率设置 云渲染视频流的最高帧数。默认为25,目前支持最高每秒60帧。
自定义视频流编码分辨率 自定义视频流编码的分辨率。
注:自定义视频流编码分辨率和实例的分辨设置不同。主要应用在主屏和操作设备各自采用不同的分辨率的情况下。
编码传输
设置云渲染视频流的编码传输模式。根据不同的模式,所需的带宽也不同。
速率控制模式 选择速率的控制模式,分为ConstQP、CBR、VBR三种模式。
二次编码 选择二次编码的模式,分为单次编码、二次编码(首次1/4分辨率)、二次编码(首次全分辨率)三种模式。
H264量化参数QP 设置最大QP值。当值增大,码率会降低,操作便流畅,但画质会降低。
IDR帧间隔 IDR帧间隔越小,画质恢复的越快。但是需要的码率也会增大。
最大码率 最大码率要根据实际网络贷款进行设置。如果值太低就不能充分利用带宽;如果太高,超过实际网络带宽则会出现卡顿。
访问权限
访问令牌 指定云服务的访问令牌。
生成随机TOKEN 自动生成一个访问令牌。
重置 重置访问令牌。
附加参数
其他附加参数。
通用选项
关于实例的高级设置选项。
实例空闲时暂停三维渲染
当没有客户端连接时,自动暂停三维渲染,以节约资源。
自定义云渲染程序视频流传输端口
设置云渲染程序视频流的传数据端口区间,即UDP端口的区间。
当前Cloud的UDP接口从50000为开始,默认到60000。UDP端口支持自定义范围。每增加一个实例并发访问,就需要增加1个UDP接口。
例: 当客户需要100个实例并发访问需求,则需要设置UDP端口为“50000 ~ 50099”,共计100个UDP接口。
手动分配显卡索引
开启后可以在“实例设置”中修改显卡的索引。
注:手动修改显卡所以如果设置的索引值不正确,可能导致实例启动失败。
实例崩溃时不显示提示对话框
勾选后当云服务实例崩溃时,不弹出对话框。
拓展阅读: 端口号的范围是从1~65535。其中1~1024是被RFC 3232规定好了的,被称作“众所周知的端口”(Well Known Ports);从1025~65535的端口被称为动态端口(Dynamic Ports),可用来建立与其它主机的会话,也可由用户自定义用途。 一些常见的端口号及其用途如下:
- 21端口:FTP 文件传输服务;
- 22端口:SSH 端口;
- 23端口:TELNET 终端仿真服务;
- 25端口:SMTP 简单邮件传输服务;
- 53端口:DNS 域名解析服务;
- 80端口:HTTP 超文本传输服务;
- 110端口:POP3 “邮局协议版本3”使用的端口;
- 443端口:HTTPS 加密的超文本传输服务;
- 1433端口:MS SQL*SERVER数据库 默认端口号;
- 1521端口:Oracle数据库服务;
- 1863端口:MSN Messenger的文件传输功能所使用的端口;
- 3306端口:MYSQL 默认端口号;
- 3389端口:Microsoft RDP 微软远程桌面使用的端口;
- 5631端口:Symantec pcAnywhere 远程控制数据传输时使用的端口;
- 5632端口:Symantec pcAnywhere 主控端扫描被控端时使用的端口;
- 5000端口:MS SQL Server使用的端口;
- 8000端口:腾讯QQ。 在设置UDP端口的时候,需要注意避开以上端口。
接口测试
二次开发的相关调试页面。
包括视频流测试、API示例、实例管理接口、样例集锦等。
更多详细操作,请查阅章节接口调试
文件资源
文件资源列表,可以管理和同步资源库和工程中的其他所引用的资源(例如图片、视频等内容)。
同步后的文件资源会存放在“~:\FreeCloudData\Resources”目录下。
文件资源树
展示当前所加载的资源列表。
资源路径
展示当前选择的资源文件的相对路径,用于二次开发等。
设置资源目录
指定一个目录作为文件资源目录。
选择目录 指定一个文件夹目录作为资源目录。目录中应当存放资源库文件和其他需要引用的资源。
打开 打开文件资源目录,用于查看、管理资源文件。
同步
刷新
在资源管理器中添加或删除了文件后,刷新文件资源树。
同步
将文件资源树中的资源文件同步到各个节点设备中。Cloud会自动在节点设备上最大的磁盘上创建一个目录存放工程文件。目录为“~:\FreeCloudData\Resources”
同步时会终止所有渲染节点上正在运行的实例。 同步目录无法手动更改。
同步时删除列表中不存在的文件
同步时,将文件资源树中不存在的资源文件从各个节点设备中删除。
矢量切片
Cloud支持将VTPK切片文件发布为MVT服务。发布的MVT服务,可以在Explorer中作为小地图或大地图进行展示。
发布切片
将VTPK文件发布为矢量切片。
选择CloudMaster的 “矢量切片”。
Clou界面右侧的提示变为 “发布VectorTile” 界面。
选择 "添加文件",加载本地一个或多个VTPK文件。
Cloud自动发布加载的文件。
显示发布结果
发布完成后,选择 “显示发布结果”,可以查看已经发布的切片服务。
操作
选择任意一个服务,可以进行以下操作:
复制服务地址
复制此服务的地址。
测试地址是否有效
测试选择的服务是否有效。如果服务有效,将会在浏览器中显示类似的内容。需Cloud启动服务。
删除
删除选择的服务。此操作不可逆。
使用发布数据
完成以后如果想使用发布好的数据,需要 “启动” Cloud云服务,这样就可以通过HTTP服务使用发布好的数据了。
更多详细操作,请查阅 MVT地图服务
系统维护
定时重启
定时重启所有服务
指定一个时间,重启所有的服务。
每天重启时刻
取值范围为0点到23点。默认为凌晨3点。
自定义实例ID
自定义实例ID(IID)的相关设置。 默认情况下实例ID是自动生成的,如需手动指定,请选择“自定义”进行设置。
- 自定义 自定义实例的ID。
操作
- 选择“自定义”,弹出“自定义实例ID”的面板。
- 在列表中选择一个实例。
在“新实例ID”中输入新的实例ID,并“应用”。也可以选择“自动生成”一个新的ID。
注:
- 需要在停止服务的状态下进行操作
- 只能修改本机的实例ID,如果要修改节点的IID,请把安装目录~\CloudMaster\CustomIID.exe拷贝到节点机上运行。
实用工具
内置的多个实用工具。
DirectX诊断工具 启动DirectX,并进行诊断。该工具报告有关DirectX组件和安装在系统上的驱动程序的详细信息。
NVIDIA驱动程序下载 前往NVIDIA官网,下载对应的驱动程序。
CloudTest网络测试工具 启动CloudTest网络测试工具。该工具包括了对TCP、UDP、STUN/TURN、网络带宽的测试。
CloudTest是一个单独的测试工具。用户可以直接选择运行,也可以“复制下载链接”后将工具拷贝至其他设备进行检测。
运行日志
查看Cloud运行的相关日志内容及操作。
保存 将日志信息保存到指定位置。
显示配置信息 显示Cloud的相关配置内容。
显示系统信息 获取当前设备的系统信息。
显示所有错误码 显示错误代码的信息。
清空 清空当前所有的日志信息。
NodeService使用说明
关于NodeService的使用说明。
设置服务器
NodeService初次启动时,需通过命令行窗口配置。在主控机的CloudMaster启动服务后,在命令行窗口中需依次输入主控机的“信令服务地址”和“Manager端口”信息并回车。
NodeService启动后会在任务栏上显示相应的图标。在图标上右键可以打开操作菜单。
打开日志文件夹
打开当前节点设备的日志文件夹目录。
退出NodeService
退出NodeService。
接口测试页面
二次开发的相关调试页面。选择一个实例,运行相应的操作,即可查看调试页面。
视频流测试
进入云渲染的三维界面,如下图:
API示例
完整的接口测试页面,里面包含了所有接口测试代码。
页面左侧是所有接口列表,右边是实时日志输出,右下为三维窗口,可以实时编辑JS代码,即时运行看到效果 。
实例管理接口
实例管理服务接口测试页面。
样例集锦
二次开发的经典样例集锦。包含多个专题及样例。
目录