智能云存储开发指南

本文档主要介绍智能云存储套餐在开发过程中的使用规则及注意事项。

对接智能云存储即视为您同意阿里云Link Visual视频云存储服务条款。智能云存储涉及到计费,具体收费策略请参见Link Visual收费策略

套餐领用和冻结

生活物联网平台提供一定量的免费云存储,每个设备只能领用一次,换一个账号绑定不可以再领取。 免费赠送的套餐查询和领取的接口有App客户端调用的接口和云云调用的接口两种。App客户端调用的接口,设计初衷是考虑到有的客户不具备云端开发能力,提供App客户端调用接口方便您开发的App直接调用领取开通云存储。云云调用的接口,是为了便于具备云端开发能力的客户可以通过云云对接的接口统一管理其自有App免费套餐和付费套餐的开通使用。建议您统一使用云云对接的接口。购买的云存储套餐生效后,不支持退款。提供了云存储套餐停用的接口,便于您自行管理C端用户的云存储套餐冻结停用。API接口请参见设置用户的云存储套餐状态

说明

开通Link Visual视频服务的项目中,所有视频产品的设备,C端用户默认可以免费领取3个月的7天循环事件云存储月套餐。

为了提高C端用户云存储套餐的购买率,您可以调用支付宝的周期性扣款接口,在云存储到期时提示C端用户自动续费。

套餐与设备和用户的关系

设备只有一个管理员用户(通过配网绑定的用户),管理员可以把设备分享给其他用户。Link Visual提供的云云对接接口不限制购买的用户类别,建议您的自有App限制管理员才能购买套餐。您的云端调用Link Visual的购买接口,为用户购买开通云存储,Link Visual会记录下购买用户,购买的云存储套餐归属于当前设备和管理员A。套餐会按购买先后顺序生效,新购买的套餐从当前有效套餐结束时间点往后追加。

设备的云存储套餐及套餐有效期内产生的数据,不随设备解绑而转移。即设备被解绑后重新绑定新的管理员用户,在这之前购买云存储套餐及设备产生的数据仍然归属于原管理员用户,不能转移给新的管理员用户。此时新管理员用户没有云存储套餐及数据。如果原管理员用户重新绑定该设备,原云存储套餐及数据在有效期内依然生效。

套餐生效顺序

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端用户的设备才有生成云端录像的配额。事件类型的套餐只能录制事件联动产生的事件录像;连续类型的套餐可以录制连续的录像,同时过程中发生的事件录像也可以录制。开通录像计划后,云端才能根据计划决定何时、如何录制生成录像。

录像计划包括连续的录像计划和事件联动的录像计划。开通录像计划需要先配置一个录像计划,再绑定录像计划到设备。只有绑定录像计划到设备,云端才会根据这个设备的录像计划进行录像生成的调度。因此,C端用户设备使用云存储录像的必要条件如下。

  • 为设备领取免费云存储套餐或者购买开通云存储套餐。

  • 为设备设置一个录像计划。

考虑到C端用户在App上购买了云存储套餐之后,有可能因为没有去开通录像计划而云端不会去调度生成云存储录像,从而引起用户疑惑。云端开通云存储套餐的接口,支持默认开通全天的录像计划,需要设置enableDefaultPlan入参为true。如果用户对录像计划有自定义的需求,则可以通过App调用录像计划的相关接口进行设置。API接口请参见视频服务。

说明

说明 enableDefaultPlan为true,云端则会为该设备开通全天的连续录像计划、全天的事件联动录像计划。该计划的默认参数为所有类型的事件都进行录像、预录时长5秒、录像时长10秒。