广东省农村党员干部现代远程教育手机客户端技术方案V2.0.doc

广东省农村党员干部现代远程教育手机客户端 1 广东省农村党员干部现代远程教育手机客广东省农村党员干部现代远程教育手机客广东省农村党员干部现代远程教育手机客广东省农村党员干部现代远程教育手机客广东省农村党员干部现代远程教育手机客广东省农村党员干部现代远程教育手机客 户端技术规范户端技术规范户端技术规范户端技术规范户端技术规范户端技术规范 中数通信息有限公司中数通信息有限公司 2011 年年 08 月月 广东省农村党员干部现代远程教育手机客户端 2 1 范围范围 5 2引用标准引用标准 6 3名词和缩略语名词和缩略语 7 4广东省农村党员干部现代远程教育手机客户端技术方案广东省农村党员干部现代远程教育手机客户端技术方案 8 4 1总体架构 8 4 2网络拓朴图 10 4 3数据接口规范 10 4 3 1数据交互协议 10 4 3 2数据格式 10 4 3 3数据安全性 11 4 4客户端鉴权 11 4 4 1客户端用户 11 4 4 2客户端用户登录密码 11 4 4 3客户端用户权限级别 11 4 4 4客户端鉴权技术实现流程 11 4 4 5客户端鉴权数据接口 12 4 5客户端适配 13 4 6视频学习 13 4 6 1与华为接口对接进行发布视频 13 4 6 2视频属性及实现方式 14 4 6 3客户端播放视频 14 4 6 4客户端播放视频技术实现流程 15 4 6 5客户端播放视频与华为对接技术实现流程 15 4 6 6视频发布接口 16 4 7开机率查询 17 4 7 1客户端查询开机率权限 17 4 7 2从华为平台同步开机率数据 17 4 7 3客户端展现开机率 18 4 7 4开机率接口流程图 18 4 7 5开机率接口 19 4 8通知通告 20 4 8 1客户端通知通告来源 20 4 8 2通知通告技术实现流程 20 4 8 3通知通告数据接口 21 4 9辅网资讯 22 4 9 1客户端辅网资讯栏目 22 4 9 2客户端辅网资讯来源 22 4 9 3客户端辅网资讯属性 22 4 9 4辅网资讯技术实现流程 23 4 9 5辅网资讯数据接口 23 广东省农村党员干部现代远程教育手机客户端 3 4 10竞赛活动 25 4 10 1竞赛活动管理 25 4 10 2竞赛活动相关竞赛题目管理 25 4 10 3竞赛活动数据统计管理 25 4 10 4客户端竞赛活动流程 26 4 10 5客户端竞赛活动接口 26 4 10 6客户端竞赛活动提交接口 27 4 11交流互动 互动解答 28 4 11 1互动解答 28 4 11 2用户提交问题流程 29 4 11 3用户提交问题管理 29 4 11 4专家解答流程 29 4 11 5互动解答接口 30 4 12交流互动 在线调查 31 4 12 1在线调查管理 31 4 12 2客户端在线调查流程 31 4 12 3客户端在线调查接口 31 4 12 4客户端在线调查提交接口 32 4 13每日知识 33 4 13 1客户端每日知识栏目 33 4 13 2客户端每日知识来源 34 4 13 3客户端每日知识属性 34 4 13 4每日知识技术实现流程 34 4 13 5每日知识数据接口 35 4 14查询管理 36 4 14 1课件查询技术实现方式 36 4 14 2课件查询接口 37 4 14 3搜索查询技术实现方式 38 4 14 4搜索查询接口 38 4 15我的收藏 39 4 15 1用户收藏的范围 39 4 15 2用户收藏技术实现方式 39 4 15 3收藏夹 39 4 15 4游览记录 40 4 15 5个人收藏列表接口 40 4 15 6个人收藏接口 41 4 16天翼应用 42 4 16 1实现天翼应用管理 42 4 16 2客户端实现天翼应用展现 42 4 16 3查询应用接口 43 4 17升级功能 44 4 17 1实现客户端版本管理 44 4 17 2实现客户端版本升级 44 4 18后台管理系统 45 广东省农村党员干部现代远程教育手机客户端 4 4 18 1用户及权限角色 45 4 18 2辅助网站后台管理平台扩展 46 4 18 2 1栏目管理 46 4 18 2 2内容管理 46 4 18 3内容安全检查 48 4 18 4 统计分析管理 48 广东省农村党员干部现代远程教育手机客户端 5 1 范围范围 本规范用于规定广东省农村党员干部现代远程教育手机客户端 以下简称远 教客户端 的技术框架和开发要求 广东省农村党员干部现代远程教育手机客户端 6 2 引用标准引用标准 下列文件中的条款通过本标准的引用而成为本标准的条款 凡是注日期的 引用文件 其随后所有的修改单 不包括勘误的内容 或修订版均不适用于本 标准 然而 鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新 版本 凡是不注日期的引用文件 其最新版本适用于本标准 rfc1889 a transport protocol for real time applications rfc2326 real time streaming protocol rfc2327 session description protocol rfc3611 rtp control protocol extended reports rfc3711 the secure real time transport protocol rfc2616 hypertext transfer protocol rfc3275 extensible makeup language w3c web services description language 广东省农村党员干部现代远程教育手机客户端需求书 20110811 广东省农村党员干部现代远程教育手机客户端 7 3 名词和缩略语名词和缩略语 www worldwideweb 万维网 wap wireless application protocol 无线应用协议 httphypertext transfer protocol超文本传输协议 https hypertext transfer protocol secure安全超文本传输协议 ip internet protocol 网络协议 mac media access control 媒体访问控制层 os operation system 操作系统 广东省农村党员干部现代远程教育手机客户端 8 4 广东省农村党员干部现代远程教育手机广东省农村党员干部现代远程教育手机 客户端技术方案客户端技术方案 4 1 总体架构 远教客户端主要由以下五大部件组成 android 客户端 数据接口 后台管理系 统 华为接口 内容内容内容来源内容来源说明说明 用户信息及权限角色华为平台华为平台导出数据 导 入到客户端管理平台中 通知通告来源于辅助网站扩展辅助网站功能实现 视频学习华为平台与华为作接口实现 辅网资讯来源于辅助网站扩展辅助网站功能实现 竞赛活动客户端管理平台新开发功能 交流互动客户端管理平台新开发功能 每日知识客户端管理平台新开发功能 开机率查询来源于华为平台与华为作接口实现 查询管理 课件 搜索 客户端管理平台新开发功能 我的收藏客户端管理平台新开发功能 天翼应用客户端管理平台新开发功能 升级功能客户端管理平台新开发功能 注 客户端管理平台与辅助网站管理平台合并在一起 同属一个平台 以上为注 客户端管理平台与辅助网站管理平台合并在一起 同属一个平台 以上为 方便区分 故划分为客户端管理平台与辅助网站管理平台 方便区分 故划分为客户端管理平台与辅助网站管理平台 架构图 广东省农村党员干部现代远程教育手机客户端 9 通知通告 我的收藏 android客户端 用户 android智能手机 栏目管理 辅助网站后台管理系统 pc电脑 内容管理 视频内容 管理 用户调查 管理 应用连接 管理 系统管理员 编辑人员等 可自定义角色 在线课程 评价管理 权限管理 图文 视频 客户端数据接口 鉴权会话 统计分析 华为远教平台 开机率 视频发布接口 开机率接口 视频学习 辅网资讯 竞赛活动 交流互动 每日知识 查询管理 天翼应用 开机率课件 视频播放 android 客户端 客户端 iphone 客户端 客户端 两个客户端功能一致 展现的图文 视频 及互动一致 包括通知通告 视频学习 辅网资讯 竞赛活动 交流互动 每 日知识 查询管理 开机率 课件 搜索 我的收藏 天翼应用 升级功能 数据接口 数据接口 android 客户端 iphone 客户端与服务端的数据采用 http 的方式 进行交互 管理系统 管理系统 包括权限管理 栏目管理 关键字配置 内容管理 视频内容管理 模块 用户调查管理 应用连接管理模块 在线课程评价管理模块 参数配置 管理模块 统计分析模块 华为接口 华为接口 包括视频发布到华为平台及各地市 县 市 区 镇开机率数据获 取接口 广东省农村党员干部现代远程教育手机客户端 10 4 2 网络拓朴图 远教客户端目前已经有三台服务器 分另是数据库 后台 web 网站 远远教 客户端将新增两台服务器 1 客户端接口服务器 与 web 网站功能类似 此服务器负责客户端数据并 发处理 部署软件包括 jdk1 5 tomcat5 5 操作系统使用 linux 2 华为接口服务器 负责远教后台视频发布 开机率与华为的接口服务 4 3 数据接口规范 4 3 1数据交互协议 数据接口采用 http 协议 使得数据交互的适应性更强 但任何网络的情况下 都能实现数据交互 4 3 2数据格式 广东省农村党员干部现代远程教育手机客户端 11 数据格式采用 json 的格式 比起 xml 格式 使得客户端解析更快速 提高性 能 节省数据量 4 3 3数据安全性 客户端与服务端的数据都将采用加密的方式进行传输 客户端登录后获得服务 端生成的动态密匙 当退出后动态密匙失效 通过此动态密匙进行加密 确保 数据的安全性 4 4 客户端鉴权 4 4 1客户端用户 从华为平台导出 并导入到客户端管理系统中 用户属性包括用户手机号码 姓名 所属区域 姓别 联系地址等 4 4 2客户端用户登录密码 从华为平台导出的用户 在导入到客户端管理系统中时 将密码初始化为 888888 用户登录后 提示其修改密码 如果用户不修改密码 下次登录时将 继续提示 4 4 3客户端用户权限级别 从华为平台导出 并导入到客户端管理系统后 可在辅助网站后台将广东农村 党员远教用户区分为省远教办 市远教办 县镇级站点管理员和普通农村党员 共四级 4 4 4客户端鉴权技术实现流程 广东省农村党员干部现代远程教育手机客户端 12 服服务务端端 客客户户端端 用户在智能手机上 打开远教客户端 输入号码 客户端调用服务端 鉴权接口 是否存在注册号码鉴权通过进入客户端首页 鉴权失败 提示用 户输入正确手机号 码 是 否 1 用户在客户端登录上输入号码和密码 2 客户端请求服务端鉴权接口 3 服务端在数据库里查找是否存在注册号码 并进行批配 4 将鉴权信息返回客户端 5 如果鉴权通过则进入客户端首页 6 如果不通过则提示输入正确的号码 4 4 5客户端鉴权数据接口 接口说明 接口说明 接口名称接口名称客户端鉴权接口 接口方向接口方向客户端 服务器 接口描述接口描述用于客户端与服务端之间进行鉴权 接口协议接口协议基于 http 的协议 请求参数 请求参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 广东省农村党员干部现代远程教育手机客户端 13 useraccount 用户手机号码string19m hashcode哈希码string32 m timestamp时间戳string18 m 响应参数 响应参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 resultcode 操作结果编码 1 成功 2 不存在此用户 string4m keycode动态密匙string50m 接口说明 接口说明 1 哈希码加密公式 md5 md5encrypt 用户账号 timestamp key key 为 双方约定的 key 4 5 客户端适配 由于用户的手机配置都不一样 所以在第一次登录客户端时 客户端需要 对用户的手机进行一次适配 包括识别并匹配用户手的屏幕大小及图像分辨率 等参数 便于用户在使用时达到最好的视觉效果 1 手机型号 屏幕大小 分辨率 2 系统版本 android 2 1 版本以上 4 6 视频学习 4 6 1与华为接口对接进行发布视频 客户端的视频由视频发布管理后台发布 视频片源由省远程办提供 通过 广东省农村党员干部现代远程教育手机客户端 14 与华为平台对接发布到华为平台 格式使用 wmv 格式 发布流程 管理员 登录后台管理系统 选择发布视频操作菜单 系统弹出视频 发布表单 选择分类 选择上传视频文件 输入视频相关属性 提交完成 视频进入审核状态 华为平台 华为接口 远远教教辅辅网网后后台台 数数网网 登录后台 管理系统 进入视频 发布管理 选择3gp或 mp4格式 的视频文 件 调用华为接口 上传到远 教服务器 将视频文件上传到 华为平台 华为平台处理视频 返回唯一识标id 播放地址 文件大 小 播放时长 华为接口 1 管理员登录后台管理系统 2 进入视频发布管理 选择 3gp 或 mp4 格式的文件 3 调用华为接口将视频文件上传到华为平台 4 华为平台处理视频后返回唯一识标 id 播放地址 文件大小 播放时长 5 客户端调用播放 4 6 2视频属性及实现方式 序序 号号 属性属性说明说明实现方式说明实现方式说明 1id视频的唯一 id保存到数网数据库中 2标题视频标题 不超过 250 个字符保存到数网数据库中 3图片图片的 intnet 地址 根据目前 主流的手机屏幕大小进行适配 保存到数网数据库中 广东省农村党员干部现代远程教育手机客户端 15 4发布日 期 视频发布日期保存到数网数据库中 5介绍视频简介 不超过 1000 个字符保存到数网数据库中 6片长视频的时长从华为接口获取 7大小视频的文件大小从华为接口获取 8播放次 数 每播放一次计一次保存到数网数据库中 9播放地 址 rtsp 视频点播地址从华为接口获取 4 6 3客户端播放视频 视频类栏目精彩内容 支持全屏 横屏播放 内容分类整理 并提供视频 搜索及收藏功能 4 6 4客户端播放视频流程 用户鉴权进入客户 端首页 进入视频相应栏目 通过手动上 下滑动 列表 视频是否在当前页 点更多显示下一页 内容 点击视频标题查看详细内容 返回上一页收藏 否 是播放 广东省农村党员干部现代远程教育手机客户端 16 4 6 5客户端播放视频与华为对接技术实现流程 华为平台客户端 客户选择播放的视频 通过华为平台返回 的id调用华为接口 华为接口 接口返回播放地 址 大小 时长 客户端进行播放 1 客户端选择播放的视频 2 通过华为平台返回的 id 调用相应的接口 3 调用华为接口返回播放地址 大小 时长 4 客户端调用播放 4 6 6视频发布接口 接口说明 接口说明 接口名称接口名称华为视频发布接口 接口方向接口方向远教辅网 华为平台 接口描述接口描述视频发布到华为平台的接口 请求参数 请求参数 名称名称说明说明是否必选是否必选 视频文件 3gp 或 mp4 发布的视频文件m 广东省农村党员干部现代远程教育手机客户端 17 上传时间视频文件上传的时间 m 响应参数 响应参数 名称名称说明说明是否必选是否必选 视频唯一标识 华为平台返回一个唯一 的标识 m 视频播放地址rtsp 视频点播地址m 视频大小视频的大小m 播放时长视频的总播放时长m 注 具体接口由华为定义 这里仅提供接口参数需求描述 注 具体接口由华为定义 这里仅提供接口参数需求描述 4 7 开机率查询 4 7 1客户端查询开机率权限 不同权限可查不同范围 省级管理员可查看所有各地市的开机率 地市管 理员可查看本地市各县镇级站点的开机率 管理员用户信息从华为平台同 步到客户端管理平台中 4 7 2从华为平台同步开机率数据 开机率按月通过调用华为接口获取 数据格式见下图 广东省农村党员干部现代远程教育手机客户端 18 1 通过地市 区域 县区 镇和月作为条件取得开机率信息 2 地市 区域 县区 镇树形结构的对应关系 考虑到这些数据是相对固 定的 所以可以考虑直接通过导出文件的方式给过来 而不需要做实时接口 3 调用接口后接口返回开机率的数据属性为 区域 县区 镇 总开机率 镇村开机率 街道社区开机率 总站点数 镇村总数 街道社区总数 总开机 站点数 镇村开机数 街道社区开机数 4 7 3客户端展现开机率 客户端展现 广东省农村党员干部现代远程教育手机客户端 19 不同权限可查不同范围 省级管理员可查看所有各地市的开机率 地市管 理员可查看本地市各县镇级站点的开机率 管理员用户信息从华为平台同 步到客户端管理平台中 4 7 4开机率接口流程图 广东省农村党员干部现代远程教育手机客户端 20 辅网后台服务 定时器扫描 每天检查是否到 达时间约定点 调用华为开机 率接口 返回开机率数 据 辅网后台 是 否 1 辅网后台服务程序定时扫描 2 每天检查是否到达时间约定点 3 如果有到达时间约定点 就调用华为开机率接口 4 返回开机率的相关数据 4 7 5开机率接口 接口说明 接口说明 接口名称接口名称华为视频发布接口 接口方向接口方向华为平台 远教辅网 接口描述接口描述开机率数据获取接口 响应参数 响应参数 名称名称说明说明是否必选是否必选 广东省农村党员干部现代远程教育手机客户端 21 站点类型如 镇村站点m 地市如 潮州m 县 市 区如 湘桥区m 镇如 凤新街道m 站点名称如 凤新街道大新乡村m 总开机天数 具体站点的月总开机天 数 m 月开机率具体站点的月开机率m 站点负责人姓名站点负责人姓名o 负责人联系电话负责人联系电话o 注 具体接口由华为定义 这里仅提供接口参数需求描述 注 具体接口由华为定义 这里仅提供接口参数需求描述 4 8 通知通告 4 8 1客户端通知通告来源 采取即时同步辅助网站通知通告栏目的内容 包括标题 内容 发布时间及作 者 远教最新动态类的通知通告远教最新动态类的通知通告 直接传达远教近期的通知通告 展示形式包括纯文字类的信息通知 图片 加文字类的手机报形式通告等 分级别通知通告分级别通知通告 根据用户的权限级别 在下发通知通告时可以选择不同的权限级别用户进 行通知通告 可以更好地起到管理的作用 4 8 2通知通告技术实现流程 广东省农村党员干部现代远程教育手机客户端 22 辅辅助助网网站站 客客户户端端 通知通告接口客户端发起请求通知通告栏目 返回客户端 取得通知内容 封装成json格式数 据 客户端展现通知通 告 5 客户端通过通知通告栏目发起请求 6 通知通告接口 取得通知内容 然后封装成合适的格式 7 返回客户端 8 用户看到目前有哪些通知公告 4 8 3通知通告数据接口 接口说明 接口说明 接口名称接口名称图文数据接口 接口方向接口方向客户端 服务器 接口描述接口描述包括客户端与服务端之间的新闻中心 通知通告 远教 动态等图文学习的数据接口 接口协议接口协议基于 http 的协议 请求参数 请求参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 广东省农村党员干部现代远程教育手机客户端 23 keycode验证返回的动态密匙string50m page页码int5 m type通知通告类型int2 m typeid子栏目 idint11 m hashcode哈希码string32 m timestamp时间戳string18 m 响应参数 响应参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 resultcode 操作结果编码 1 成功 2 验证不通过 3 不存在栏目 string4m jsondata 数据结果集 json 数据 格式 string2000m 接口说明 接口说明 1 哈希码加密公式 md5 md5encrypt 动态密匙 timestamp key key 为双方 约定的 key 4 9 辅网资讯 4 9 1客户端辅网资讯栏目 栏目包括新闻中心 南粤党建 科技兴农 卫生保健 远教动态 与辅助网站 栏目一致 新闻中心包括时事聚焦 今日三农二个子栏目 卫生保健包括营养保健 常见 疾病预防 卫生常识三个子栏目 广东省农村党员干部现代远程教育手机客户端 24 4 9 2客户端辅网资讯来源 采取即时同步辅助网站相应栏目的内容 图片 包括标题 内容 发布时间及 作者 4 9 3客户端辅网资讯属性 序号序号属性属性说明说明 1标题标题 不超过 250 个字符 2图片介绍性图片 3发布日期视频发布日期 4介绍不超过 1000 个字符 5推荐是否为推荐属性 6手工排序前台展现的顺序 管理可手工设置 7浏览权限可供不同角色用户观看 8展现方式可选择展现的方式 包括 android 客户端 iphone 客户端 辅助网站供选择 可单选和多选 4 9 4辅网资讯技术实现流程 辅网资讯相应的栏目有相应的 id 通过此 id 向辅网接口发起请求 辅助网站 响应后将数据返回给客户端 客户端展现图文内容 广东省农村党员干部现代远程教育手机客户端 25 辅辅助助网网站站 客客户户端端 辅网资讯接口客户端发起请求选择辅网资讯栏目 返回客户端 取得相应栏目内容 封装成json格式数 据 客户端展现 1 客户端通过选择辅网资讯栏目发起请求 2 通知辅网资讯接口 取得相应栏目的内容 然后封装成合适的格式 3 返回客户端 4 用户看到目前有哪些资讯 4 9 5辅网资讯数据接口 接口说明 接口说明 接口名称接口名称图文数据接口 接口方向接口方向客户端 服务器 接口描述接口描述包括客户端与服务端之间的新闻中心 通知通告 远教 动态等图文学习的数据接口 接口协议接口协议基于 http 的协议 请求参数 请求参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 keycode验证返回的动态密匙string50m 广东省农村党员干部现代远程教育手机客户端 26 page页码int5 m type 新闻中心 南粤党建 科 技兴农 卫生保健等类型 int2 m typeid子栏目 idint11 m hashcode哈希码string32 m timestamp时间戳string18 m 响应参数 响应参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 resultcode 操作结果编码 1 成功 2 验证不通过 3 不存在栏目 string4m jsondata 数据结果集 json 数据 格式 string2000m 接口说明 接口说明 1 哈希码加密公式 md5 md5encrypt 动态密匙 timestamp key key 为双方 约定的 key 4 10竞赛活动 针对农村党员远教学习内容或特定时期 举办在线知识竞赛等活动 可以 设置选择题 单项或多项 对错判断题等 方便党员远教开展丰富多彩的线上 活动 广东省农村党员干部现代远程教育手机客户端 27 4 10 1 竞赛活动管理 如建党 90 周年 创先争优 深入学习科学发展观专题等 管理员在客户端管理 系统可以动态增加或修改活动专题 4 10 2 竞赛活动相关竞赛题目管理 管理员登录客户端管理系统 选择需要发布的活动 针对此活动发布竞赛题目 输入题目 有效时间 选择题 单项或多项 对错判断题等进行发布 4 10 3 竞赛活动数据统计管理 管理员登录客户端管理系统 将以列表形式展现竞赛活动参与情况与答题情况 管理员可导出成 excel 文件到本地 4 10 4 客户端竞赛活动流程 广东省农村党员干部现代远程教育手机客户端 28 用户鉴权进入客户 端首页 进入在线考试栏目 通过手动上 下滑动 列表 试题是否在当前页 点更多显示下一页 内容 点击考试标题显示第一题 返回上一页 否 是 用户选择答案并提 交 显示下一题是否还有答题 提示用户答题完毕 是 否 4 10 5 客户端竞赛活动接口 客户端与服务端之间的竞赛活动提交信息接口 接口说明 接口说明 接口名称接口名称竞赛信息接口 接口方向接口方向客户端 服务器 接口描述接口描述客户端与服务端之间的竞赛活动信息接口 接口协议接口协议基于 http 的协议 请求参数 请求参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 keycode验证返回的动态密匙string50m page页码int5 m hashcode哈希码string32 m timestamp时间戳string18 m 响应参数 响应参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字是否必选是否必选 广东省农村党员干部现代远程教育手机客户端 29 节 节 resultcode 操作结果编码 1 成功 2 验证不通过 string4m jsondata 数据结果集 json 数据 格式 string2000m 接口说明 接口说明 1 哈希码加密公式 md5 md5encrypt 动态密匙 timestamp key key 为双方 约定的 key 4 10 6 客户端竞赛活动提交接口 接口说明 接口说明 接口名称接口名称竞赛活动提交接口 接口方向接口方向客户端 服务器 接口描述接口描述客户端与服务端之间的竞赛活动提交接口 接口协议接口协议基于 http 的协议 请求参数 请求参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 keycode验证返回的动态密匙string50m objid考题 idint11 m optid 选择项 id 多选题则多 个选项 id 用 相分离 string11 m hashcode哈希码string32 m timestamp时间戳string18 m 响应参数 响应参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字是否必选是否必选 广东省农村党员干部现代远程教育手机客户端 30 节 节 resultcode 操作结果编码 1 成功 2 验证不通过 string4m result 是否答对题目 1 是 2 否 int1m 接口说明 接口说明 1 哈希码加密公式 md5 md5encrypt 动态密匙 timestamp key key 为双方 约定的 key 4 11交流互动 互动解答 交流互动 包含有互动解答 用户调查 在线考试三个子栏目 旨在为 用户提供交流互动的平台 用户可以通过手机客户端直接与专家 远教办等进 行互动 也方便用户反馈基层信息 同时也提供考评的灵活机制 4 11 1 互动解答 用户可以通过 互动解答 这个功能通过文字形式直接问题 同时其他用 户也可以分享 解答该问题 达到互动分享的目的 互动问答的形式是所有用 户可问可答 一个问题 可以有多个用户回答 对比较好的回答可进行评分 广东省农村党员干部现代远程教育手机客户端 31 4 11 2 用户提交问题流程 用户鉴权进入客户 端首页 选择互动解答栏目输入问题 建议 输入字符不为空 提示用户重新输入 提交完成 否 是 4 11 3 用户提交问题管理 用户在客户端提交问题后 管理员登录后台管理系统 列表展现用户的问题 包括问题 发表者 发表时间 是否已经解决 管理员可查看具体的提问内容 4 11 4 专家解答流程 专家可能用户提出的问题进行解答 解答完成后可将问题设置成 已解决 登录后台管理系统进入在线问答管理 选择需要解答的问 题 审核通过进入在线问答管理审核管理员登录 输入解答题内容 显示在客户端 是 否 4 11 5 互动解答接口 广东省农村党员干部现代远程教育手机客户端 32 接口说明 接口说明 接口名称接口名称互动解答提交接口 接口方向接口方向客户端 服务器 接口描述接口描述客户端与服务端之间的互动解答提交接口 接口协议接口协议基于 http 的协议 请求参数 请求参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 keycode验证返回的动态密匙string50m content用户建议 问题内容string400 m user phone用户号码string20 hashcode哈希码string32 m timestamp时间戳string18 m 响应参数 响应参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 resultcode 操作结果编码 1 成功 2 验证不通过 string4m 接口说明 接口说明 1 哈希码加密公式 md5 md5encrypt 动态密匙 timestamp key key 为双方 约定的 key 广东省农村党员干部现代远程教育手机客户端 33 4 12交流互动 在线调查 4 12 1 在线调查管理 管理员登录客户端管理系统 输入调查题目 有效时间 选择题 单项或多项 进行发布 管理员可以查看调查情况 包括各选择项的投票人数 及导出 excel 4 12 2 客户端在线调查流程 用户在智能手机上 打开远教客户端 进入用户调查模块选择调查选项 提交完成 4 12 3 客户端在线调查接口 客户端与服务端之间的在线调查信息接口 接口说明 接口说明 接口名称接口名称在线调查接口 接口方向接口方向客户端 服务器 接口描述接口描述客户端与服务端之间的在线调查信息接口 接口协议接口协议基于 http 的协议 请求参数 请求参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 广东省农村党员干部现代远程教育手机客户端 34 keycode验证返回的动态密匙string50m page页码int5 m hashcode哈希码string32 m timestamp时间戳string18 m 响应参数 响应参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 resultcode 操作结果编码 1 成功 2 验证不通过 string4m jsondata 数据结果集 json 数据 格式 string2000m 接口说明 接口说明 2 哈希码加密公式 md5 md5encrypt 动态密匙 timestamp key key 为双方 约定的 key 4 12 4 客户端在线调查提交接口 接口说明 接口说明 接口名称接口名称在线调查提交接口 接口方向接口方向客户端 服务器 接口描述接口描述客户端与服务端之间的在线调查提交接口 接口协议接口协议基于 http 的协议 请求参数 请求参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 keycode验证返回的动态密匙string50m 广东省农村党员干部现代远程教育手机客户端 35 objid在线调查 idint11 m optid 选择项 id 多选题则多 个选项 id 用 相分离 string11 m hashcode哈希码string32 m timestamp时间戳string18 m 响应参数 响应参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 resultcode 操作结果编码 1 成功 2 验证不通过 string4m 接口说明 接口说明 2 哈希码加密公式 md5 md5encrypt 动态密匙 timestamp key key 为双方 约定的 key 4 13每日知识 4 13 1 客户端每日知识栏目 栏目包括农业知识 党建知识 科技兴农等 可在辅助网站后台增加 4 13 2 客户端每日知识来源 采取即时同步辅助网站相应栏目的内容 图片 包括标题 内容 发布时间及 作者 4 13 3 客户端每日知识属性 序号序号属性属性说明说明 广东省农村党员干部现代远程教育手机客户端 36 1标题标题 不超过 250 个字符 2图片介绍性图片 3发布日期视频发布日期 4介绍不超过 1000 个字符 5推荐是否为推荐属性 6手工排序前台展现的顺序 管理可手工设置 7浏览权限可供不同角色用户观看 8展现方式可选择展现的方式 包括 android 客户端 iphone 客户端 辅助网站供选择 可单选和多选 4 13 4 每日知识技术实现流程 每日知识相应的栏目有相应的 id 通过此 id 向辅网接口发起请求 辅助网站 响应后将数据返回给客户端 客户端展现图文内容 辅辅助助网网站站 客客户户端端 辅网每日知识接口客户端发起请求选择每日知识栏目 返回客户端 取得相应栏目内容 封装成json格式数 据 客户端展现 1 客户端通过选择每日知识栏目发起请求 2 通过每日知识接口 取得相应内容 然后封装成合适的格式 3 返回客户端 4 用户看到每日的知识信息 广东省农村党员干部现代远程教育手机客户端 37 4 13 5 每日知识数据接口 接口说明 接口说明 接口名称接口名称图文数据接口 接口方向接口方向客户端 服务器 接口描述接口描述客户端与服务端之间的每日知识的数据接口 接口协议接口协议基于 http 的协议 请求参数 请求参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 keycode验证返回的动态密匙string50m page页码int5 m type 新闻中心 南粤党建 科 技兴农 卫生保健等类型 int2 m typeid子栏目 idint11 m hashcode哈希码string32 m timestamp时间戳string18 m 响应参数 响应参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 resultcode 操作结果编码 1 成功 2 验证不通过 3 不存在栏目 string4m jsondata 数据结果集 json 数据 格式 string2000m 接口说明 接口说明 2 哈希码加密公式 md5 md5encrypt 动态密匙 timestamp key key 为双方 约定的 key 广东省农村党员干部现代远程教育手机客户端 38 4 14查询管理 查询管理 功能是为了提供给有权限的党员查询所辖范围内远教学习设 备开机情况 其中包括开机率查询 详见 4 7开机率查询 另外还有课件发 布查询及搜索查询 4 14 1 课件查询技术实现方式 为便于上级查询各个地市在某一时间段的课件发布情况 做一个排名 客 户端 选项 功能里有顺序和倒序两个排列方式选择进行排序 1 客户端通过账号取得所属地市 如果是管理员则有权限进行查询 通过地 市 排序属性请求客户端管理平台服务端 2 客户端管理平台服务端从数据库中按地市 排序属性进行统计课件发布情 况 3 客户端管理平台服务端将统计结果按 4 3数据接口规范要求封装返回给 客户端 客户端进行展现 4 14 2 课件查询接口 接口说明 接口说明 接口名称接口名称查询接口 接口方向接口方向客户端 服务器 接口描述接口描述查询课件发布情况 接口协议接口协议基于 http 的协议 请求参数 请求参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字是否必选是否必选 广东省农村党员干部现代远程教育手机客户端 39 节 节 keycode验证返回的动态密匙string50m area地市string50 m seq排序int2 m page页码int5 m hashcode哈希码string32 m timestamp时间戳string18 m 响应参数 响应参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 resultcode 操作结果编码 1 成功 2 验证不通过 string4m jsondata 数据结果集 json 数据 格式 string2000m 接口说明 接口说明 1 哈希码加密公式 md5 md5encrypt 动态密匙 timestamp key key 为双方 约定的 key 4 14 3 搜索查询技术实现方式 支持按关键词搜索图文 视频 信息公告资讯等内容搜索 包括视频学习 通知通告 辅网资讯 每日知识栏目包括子栏目的内容查找 1 客户端根据用户输入的关键字请求客户端管理平台服务端查询接口 2 客户端管理平台服务端从数据库中按关键字模湖查询标题及内容 3 客户端管理平台服务端将符合条件的结果按 4 3 数据接口规范要求封装返 回给客户端 客户端进行展现 广东省农村党员干部现代远程教育手机客户端 40 4 14 4 搜索查询接口 接口说明 接口说明 接口名称接口名称查询接口 接口方向接口方向客户端 服务器 接口描述接口描述查询图文 视频等信息的接口 接口协议接口协议基于 http 的协议 请求参数 请求参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 keycode验证返回的动态密匙string50m keyword查询关键字string50 m page页码int5 m hashcode哈希码string32 m timestamp时间戳string18 m 响应参数 响应参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 resultcode 操作结果编码 1 成功 2 验证不通过 string4m jsondata 数据结果集 json 数据 格式 string2000m 接口说明 接口说明 2 哈希码加密公式 md5 md5encrypt 动态密匙 timestamp key key 为双方 约定的 key 广东省农村党员干部现代远程教育手机客户端 41 4 15我的收藏 4 15 1 用户收藏的范围 用户可以收藏图文 视频 信息公告资讯 包括视频学习 通知通告 辅网资 讯 每日知识栏目包括子栏目的详细内容信息 当用户游览这些详细内容信息 时 系统将会记录这些游览过的信息 以便用户能快捷查询 4 15 2 用户收藏技术实现方式 1 客户端根据收藏及游览的内容请求客户端管理平台服务端登记接口 2 客户端管理平台服务端根据收藏及游览的内容和用户信息登记信息 4 15 3 收藏夹 1 客户端根据请求客户端管理平台服务端收藏夹查询接口 2 客户端管理平台服务端从数据库中查询收藏夹登记信息 3 客户端管理平台服务端按 4 3数据接口规范要求封装返回给客户端 客 户端进行展现 4 15 4 游览记录 1 客户端根据请求客户端管理平台服务端游览记录查询接口 2 客户端管理平台服务端从数据库中查询游览记录登记信息 3 客户端管理平台服务端按 4 3数据接口规范要求封装返回给客户端 客 户端进行展现 4 15 5 个人收藏列表接口 接口说明 接口说明 广东省农村党员干部现代远程教育手机客户端 42 接口名称接口名称个人收藏接口 接口方向接口方向客户端 服务器 接口描述接口描述使个人收藏保存在服务器上的接口 接口协议接口协议基于 http 的协议 请求参数 请求参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 keycode验证返回的动态密匙string50m useraccount用户号码string50 m page页码int5 m objtype1 收藏 2 游览记录int11 m hashcode哈希码string32 m timestamp时间戳string18 m 响应参数 响应参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 resultcode 操作结果编码 1 成功 2 验证不通过 string4m jsondata 数据结果集 json 数据 格式 string2000m 接口说明 接口说明 2 哈希码加密公式 md5 md5encrypt 动态密匙 timestamp key key 为 双方约定的 key 4 15 6 个人收藏接口 接口说明 接口说明 接口名称接口名称个人收藏接口 广东省农村党员干部现代远程教育手机客户端 43 接口方向接口方向客户端 服务器 接口描述接口描述使个人收藏保存在服务器上的接口 接口协议接口协议基于 http 的协议 请求参数 请求参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 keycode验证返回的动态密匙string50m useraccount用户号码string50 m type 类型 图文 视频 在线 考试等 int2 m objid收藏的对像 idint11 m objtype1 收藏 2 游览记录int11 m hashcode哈希码string32 m timestamp时间戳string18 m 响应参数 响应参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 resultcode 操作结果编码 1 成功 2 验证不通过 string4m 接口说明 接口说明 3 哈希码加密公式 md5 md5encrypt 动态密匙 timestamp key key 为 双方约定的 key 4 16天翼应用 在客户端栏目里 还融合进更多的电信增值业务 比如有 天翼视讯 广东省农村党员干部现代远程教育手机客户端 44 天翼阅读 天翼空间 等电信热门的 3g 应用 用户可以根据自己的喜好进 行集成配置 配置成功后 该应用的菜单会出现在客户端主界面上默认融合 天翼视讯 的应用 4 16 1 实现天翼应用管理 管理员登录客户端管理平台 输入应用名称 logo 图片 相应连接 提交发布 成功 应用保存到数据库中供客户端查询展现 4 16 2 客户端实现天翼应用展现 1 客户端请求客户端管理平台服务端应用查询接口 2 客户端管理平台服务端从数据库中查询天翼应用登记信息 3 客户端管理平台服务端按 4 3数据接口规范要求封装返回给客户端 客 户端进行展现 4 16 3 查询应用接口 接口说明 接口说明 接口名称接口名称查询应用接口 接口方向接口方向客户端 服务器 接口描述接口描述查询应用接口 接口协议接口协议基于 http 的协议 请求参数 请求参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 keycode验证返回的动态密匙string50m useraccount用户号码string50 m 广东省农村党员干部现代远程教育手机客户端 45 hashcode哈希码string32 m timestamp时间戳string18 m 响应参数 响应参数 名称名称说明说明数据类型数据类型最大长度 字最大长度 字 节 节 是否必选是否必选 resultcode 操作结果编码 1 成功 2 验证不通过 string4m jsondata 数据结果集 json 数据 格式 string