问卷功能

1.文档概述

此文档为独立接入问卷功能,并对西瓜API没有依赖关系的客户端功能文档。
问卷功能主要分为两个部分:刷新问卷和打开问卷。
请在此处下载接入问卷的资源,资源中包含的资源如图所示:

1.1 文档结构

  1. 文档概述
  2. 客户端接口
  3. 回调函数

2 客户端接口

2.1 刷新问卷

接口定义:

-(void) freshQuestionnaireAsync

接口说明:刷新页面时调用此函数
参数说明:
关于 QRRoleInfo 的成员说明:

参数 参数类型 说明
uid string 玩家uid
roleId string 角色ID
roleType string 玩家角色类型
roleLevel string 角色等级
roleVipLevel string 角色VIP等级
serverId string 服ID
zoneId string 区ID
roleName string 玩家角色名称
serverName string 服名称
zoneName string 区名称
partyName string 所在公会或帮派
gender string 性别
missionId string 关卡ID
missionName string 关卡名称
ageInGame string 游戏年龄,单位:天
accountAgeInGame string 帐号年龄,单位:天
questId string 问卷ID
questName string 问卷名称
roleFigure string 角色体型(萝莉、大叔等)
ext string 拓展接口,格式为JSON串

关于 QuestionnaireConfig 的成员说明:

参数 参数类型 说明
gameId string 游戏ID
channel string 渠道名称

2.2 打开问卷

接口定义:

-(void) showQuestionnaireWithVC:(UIViewController *)viewController percent:(NSString *)percent customParams:(NSString *)customParams;

接口说明: 当游戏有通过游戏用户在线分发问卷的需求时,可以通过本SDK的接入简化开发提高效率节省成本。
参数说明:

viewController 展示问卷的视图
percent 打开问卷窗口的宽度占屏幕的百分比,100表示全屏
customParams json串格式自定义参数

3 回调函数

3.1 刷新问卷回调

接口定义:

-(void) onQuestionnaireFreshed:(NSString *)questionnaireName;

接口说明:刷新问卷回调
参数说明:

questionnaireName 任务名称

3.2 打开问卷回调

接口定义:

-(void) doQuestionnaireOpened

接口说明:打开问卷回调

3.3 提交问卷

接口定义:

-(void) onQuestionnaireFinished:(NSString *)giftInfo;

接口说明:提交问卷回调
参数说明:

giftInfo 问卷编号