C 端用户续费增值服务

更新时间:2024-04-26 07:51:40下载pdf

对于出行产品而言,用户运营是强需求。出行产品提供非常丰富的高级能力,这些高级能力在行业里一般采用首年赠送,次年由 C 端用户自行选择续费,续费后则可享有全部功能。若不续费,则仅保留基础功能,双协议设备保留蓝牙相关的功能,单蜂窝协议禁用全部功能。

SDK 开发者可依据以下接口数据,校验相关增值服务逻辑。

C 端用户续费增值服务

类名(协议名) 说明
TSODValueAddedServicesService 增值服务相关服务
TSODValueAddedServicesModel 增值服务模型

获取 C 端用户续费增值服务

判断设备的增值服务是否在服务中。若不在服务中,则禁用需要付费的高级增值服务并引导 C 端用户进行续费。

接口说明

/// Get value-added services
/// - Parameters:
///   - devID: device ID
///   - success: success callback
///   - failure: failure callback
+ (void)fetchValueAddedServicesWithDevID:(NSString *)devID success:(void(^)(TSODValueAddedServicesModel *valueAddedServicesModel))success failure:(ThingFailureError)failure;

示例代码

    [TSODValueAddedServicesService fetchValueAddedServicesWithDevID:self.device.deviceModel.devId success:^(TSODValueAddedServicesModel * _Nonnull valueaddedServicesModel) {
        //...
    } failure:^(NSError * _Nonnull error) {
        //...
    }];

TSODValueAddedServicesModel 数据模型

字段 类型 描述
devId NSString 设备 ID
uuid NSString 设备 UUID
abilityMap NSDictionary 增值服务能力

设置 C 端用户续费增值服务弹窗

增值服务权益激活弹窗是否弹出过。弹出后,单击关闭操作的回调中调用此接口,会更新 TSODValueAddedServicesModel 模型中对应能力的 hadPopup 字段。

接口说明

/// Set value-added services VASAbilityModel - hadPopup
/// - Parameters:
///   - devID: device ID
///   - hadPopup: ture or false, only AbilityDataCloudStore can set this field.
///   - success: success callback
///   - failure: failure callback
+ (void)setValueAddedServicesPopWithDevID:(NSString *)devID hadPopup:(BOOL)hadPopup success:(ThingSuccessBOOL)success failure:(ThingFailureError)failure;

示例代码

    [TSODValueAddedServicesService setValueAddedServicesPopWithDevID:self.deviceM.devId hadPopup:YES success:^(BOOL result) {
        //...
    } failure:^(NSError * _Nonnull error) {
        //...
    }];