Cloud 升级说明

全新的Cloud高渲染云服务平台，相比之前的V4.3版本拥有大量的提升。本章详细说明了相关升级内容。

Cloud V5.0 的SDK变化

Cloud V5.00在功能上有了很大的升级，相比V4.3版本主要有以下几个方面：

支持分布式部署，可以部署多台渲染机器，实现自动分配资源.
减少了端口占用量，V 4.3每个实例需要3个端口，现在每个实例不再需要这3个端口，只有全局的几个端口号.
优化了端口映射功能（只需要映射2个端口即可），内外网部署更加方便。
优化了API调用方式，之前通过WebSocket进行调用，这种调用方式无法实现P2P，网络比较复杂时，接口就无法调用了，现在直接通过WebRTC进行API调用，不再受网络环境影响。
支持Https配置。

如何从V4.3无缝升级到V5.0

从V4.3升级到V5.0是很简单的，代码几乎不用做什么改动就可以升级。

升级步骤：

安装AirCityCloud Release5.0的软件包，并启动CloudMaster服务。
更新ac.min.js，用SDK目录下的ac.min.js替换一下之前4.3版本的文件。

唯一有点变化的地方是AirCityPlayer、AirCityAPI两个类的初始化，下面详细说明一下。

Cloud V4.3初始化这2个类的代码逻辑如下：

//AirCityPlayer初始化
let options = {
'domId': 'player',
'token': HostConfig.Token,
'showMarker': true,
'showStartupInfo': true
};
let aircityPlayer = new AirCityPlayer(HostConfig.instanceId ||
HostConfig.AirCityPlayer, options);
//AirCityAPI初始化
let apiOptions = {
'onReady': () => { }, //此时可以调用接口了
'onApiVersion': (vNo, vType) => {},
'onEvent': (e) => { },
'onLog': log,
'useColorLog': true //仅用于SDK测试页面，二次开发请忽略
};
let aircityApi = new AirCityAPI(HostConfig.instanceId || HostConfig.AirCityAPI,
apiOptions);

Cloud V5.0 的初始化逻辑如下：

//AirCityPlayer初始化
let options = {
'domId': 'player',
'token': HostConfig.Token,
'showMarker': true,
'showStartupInfo': true,
'apiOptions': {
'onReady': () => { },
'onApiVersion': (vNo, vType) => {},
'onEvent': (e) => { },
'onLog': log,
'useColorLog': true
}
};
let aircityPlayer = new AirCityPlayer(HostConfig.instanceId ||
HostConfig.AirCityPlayer, options);
let aircityApi = aircityPlayer.getAPI();

从V5.0的初始化逻辑可以看到V5.0不再需要显式初始化AirCityAPI对象了，只需要在初始化AirCityPlayer的选项中指定apiOptions就会自动在内部初始化AirCityAPI对象，之后便可以通过getAPI方法获取 AirCityAPI对象（当然也可以通过 __g 全局变量进行接口调用）。

如果只是想展示三维视频流而不需要API调用，可以不用指定apiOptions属性，这样就不会初始化AirCityAPI。

上面的V5.0初始化逻辑是默认情况下的初始化流程，默认情况下的API调用是通过WebRTC。如果由于特殊原因，想使用4.3WebSocket方式调用也是可以的，V5.0默认不开启WebSocket端口，如果要开启，可以在CloudMaster的实例列表页，双击实例，在高级参数里开启WebSocket API调用。

Cloud V5.0使用WebSocket进行API电泳的初始化代码跟V4.3完全一致。

除了AirCityPlayer、AirCityAPI两个对象的初始化4.3和5.0有点区别外，其他接口的调用完全一致

升级注意事项