云存储开发指南
RTCX视频云平台支持用户自己的平台来调用RTCX视频云平台提供的套餐相关接口，实现可用套餐查询、套餐购买（支持立即生效或作为备用套餐，后期生效）、查看购买套餐订单列表和详情、套餐立即生效、冻结或转移。套餐购买后如果生效了，就可以实现视频录制的云存储功能。见总体流程和详细流程。
同时介绍了RTCX云存储套餐在开发过程中的使用规则及注意事项。
整体流程
详细流程
-
企业管理员通过RTCX视频云平台控制台进行账号充值。
-
用户通过App查询云存储套餐列表，客户云平台通过HTTP POST方式调用RTCX视频平台开放接口获取。API接口请参见查询云存储套餐列表。
-
用户通过App购买套餐，客户云平台通过HTTP POST方式调用RTCX视频平台开放接口进行购买，API接口请参见购买云存储套餐。
-
用户通过App查看购买套餐订单列表或详情，客户云平台通过HTTP POST方式调用RTCX视频平台开放接口获取，此步骤可选，API接口请参见查询云存储套餐的订单列表或获取云存储套餐的订单详情。
-
用户通过App立即生效或冻结已购买的套餐（或实现多个套餐的生效顺序），客户云平台通过HTTP POST方式调用RTCX视频平台开放接口进行操作，此步骤可选，API接口请参见设置云存储立即生效或设置用户的云存储套餐状态。
-
用户通过App实现已购买的套餐从一个设备转移到另一个设备，客户云平台通过HTTP POST方式调用RTCX视频平台开放接口实现，此步骤可选，API接口请参见用户云存储套餐转移。
试用套餐
设备添加后，用户如果没有购买云存储套餐，一般会提供一个默认的1天试用套餐。试用套餐暂时只支持图片存储。当用户购买了云存储套餐后，该试用套餐会自动失效。不支持对试用套餐的各种操作，比如：查看套餐订单列表、套餐立即生效或冻结、套餐转移等。
套餐冻结
用户购买的云存储套餐生效后，不支持退款。提供了云存储套餐停用的接口，便于您自行管理C端用户的云存储套餐冻结停用。API接口请参见设置用户的云存储套餐状态。
套餐与设备关系
您的云端调用RTCX云平台的购买接口，为用户购买开通云存储，购买的云存储套餐归属于当前设备。套餐会按购买先后顺序生效，新购买的套餐从当前有效套餐结束时间点往后追加。
设备的云存储套餐及套餐有效期内产生的数据，不随设备解绑而转移。即设备被解绑后重新绑定新的用户，在这之前购买云存储套餐及设备产生的数据仍然归属于原用户，不能转移给新的用户。此时新用户没有云存储套餐及数据。如果原用户重新绑定该设备，原云存储套餐及数据在有效期内依然生效。
套餐生效顺序
C端用户给设备购买云存储套餐，默认按照开通的先后生效。套餐查询接口都会返回每个套餐详情，包括开始时间、结束时间。付费套餐的开通接口，有入参（immediateUse）来指定该套餐开通后是否要调整为立即生效。举个例子：用户当前已经有了A、B两个套餐，如果再新购买一个套餐C，则默认是在A、B两个套餐之后生效；如果厂商云端指定新购套餐C要立即生效，也就是指定immediateUse=true，那么新购买的套餐C立即生效，用户的套餐使用顺序调整为C、A、B。
如果在使用过程中需要调整套餐的先后顺序，那么可以通过设置云存储套餐立即生效的接口来调整。付费购买的套餐调用设置云存储套餐立即生效这个接口来调整。例如：用户当前已经有了A、B、C三个套餐，三个套餐的生效顺序是A->B->C，A、B、C都是付费套餐。如果用户需要将C调整为立即生效，那么调用设置云存储套餐立即生效的接口将C套餐设置为立即生效，这时候新的套餐顺序为C->A->B；如果后续又希望调整为A套餐立即生效，那么调用设置云存储套餐立即生效的接口将A套餐设置为立即生效，这时候新的套餐顺序重新调 整为A->C->B。
套餐转移
考虑到C端用户在使用云存储套餐的过程可能会遇到设备有问题需要退换货的情形，支持C端用户将原先设备购买的云存储套餐转移到新的设备上。API接口请参见用户云存储套餐转移。
套餐与录像计划
开通云存储套餐后C端用户的设备才有生成云端录像的配额。事件类型的套餐只能录制事件联动产生的事件录像；连续类型的套餐可以录制连续的录像，同时过程中发生的事件录像也可以录制。开通录像计划后，云端才能根据计划决定何时、如何录制生成录像。
录像计划包括连续的录像计划和事件联动的录像计划。开通录像计划需要先选定设备，然后通过AppSDK接口配置一个录像计划。因此，C端用户设备使用云存储录像的必要条件如下：
- 为设备已有免费云存储套餐或者购买开通云存储套餐。
- 为设备设置了一个录像计划。