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

  1. 打开AirCity Cloud.ISO镜像文件,弹出内容文件夹。、

  2. 运行“Setup.exe”程序,在短暂的准备进度后,进入安装欢迎界面。

  3. 选择“下一步”,进入“许可证协议”页面。

  4. 请仔细阅读《最终用户许可协议》。如果同意协议,请选择“”。若不同意,请选择“”结束安装。

  5. 选择安装路径。要安装到默认目录,请直接选择“下一步”。要安装到其他文件夹,请选择“浏览”,然后选择其他文件夹。

  6. 选择“安装”,以开始安装。

  7. 安装过程需要若干分钟,请耐心等待。

  8. 当安装完毕,出现完成窗口。单击“完成”,完成Cloud软件的安装。

  9. 安装完成后,在电脑的“开始”菜单和桌面增加CloudMaster和NodeService的快捷方式。

 

安装CloudMaster

  1. 打开AirCity CloudMaster.exe,在短暂的准备进度后,进入安装欢迎界面。

  2. 选择“下一步”,进入“许可证协议”页面。

  3. 请仔细阅读《最终用户许可协议》。如果同意协议,请选择“”。若不同意,请选择“”结束安装。

  4. 选择安装路径。要安装到默认目录,请直接选择“下一步”。要安装到其他文件夹,请选择“浏览”,然后选择其他文件夹。

  5. 选择“安装”,以开始安装。

  6. 安装过程需要若干分钟,请耐心等待。

  7. 当安装完毕,出现完成窗口。单击“完成”,完成CloudMaster软件的安装。

  8. 安装完成后,在电脑的“开始”菜单和桌面增加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文件发布为矢量切片。

  1. 选择CloudMaster的 “矢量切片”

  2. Clou界面右侧的提示变为 “发布VectorTile” 界面。

  3. 选择 "添加文件",加载本地一个或多个VTPK文件。

  4. Cloud自动发布加载的文件。

 

显示发布结果

发布完成后,选择 “显示发布结果”,可以查看已经发布的切片服务。

操作

选择任意一个服务,可以进行以下操作:

  • 复制服务地址

    复制此服务的地址。

  • 测试地址是否有效

    测试选择的服务是否有效。如果服务有效,将会在浏览器中显示类似的内容。需Cloud启动服务。

  • 删除

    删除选择的服务。此操作不可逆。

 

使用发布数据

完成以后如果想使用发布好的数据,需要 “启动” Cloud云服务,这样就可以通过HTTP服务使用发布好的数据了。

更多详细操作,请查阅 MVT地图服务

 


系统维护

定时重启

  • 定时重启所有服务

    指定一个时间,重启所有的服务。

  • 每天重启时刻

    取值范围为0点到23点。默认为凌晨3点。

 

自定义实例ID

自定义实例ID(IID)的相关设置。 默认情况下实例ID是自动生成的,如需手动指定,请选择“自定义”进行设置。

  • 自定义 自定义实例的ID。

操作

  1. 选择“自定义”,弹出“自定义实例ID”的面板。
  2. 在列表中选择一个实例。
  3. 在“新实例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代码,即时运行看到效果 。

 

实例管理接口

实例管理服务接口测试页面。

 

样例集锦

二次开发的经典样例集锦。包含多个专题及样例。

 


目录


© Copyright 2023 北京飞渡科技有限公司

京ICP备17012026号-4

results matching ""

    No results matching ""

    results matching ""

      No results matching ""