中国移动MMarket客户端规范.doc

中国移动通信企业标准QB-M-Market业务客户端规范Specification For M-Market Service Client版本号：1.2.0-实施-发布中国移动通信集团公司 发布目 录前 言III1范围12规范性引用文件13术语、定义和缩略语13.1术语、定义13.2缩略语24业务概念25功能要求25.1登录/注销登录25.1.1登录流程35.1.2用户登录失败后的重试以及登录成功后的断线重连35.1.3主动注销登录和被动退出35.2应用列表和内容获取35.3应用展示35.3.1分类展示35.3.2特色推荐35.3.3免费应用列表45.3.4排行展示45.4查看详情45.5预览45.5.1预览图格式45.6应用评论/评级45.7搜索55.8应用管理55.8.1购买的应用的管理55.8.2下载的应用管理55.9应用推荐55.10计费与业务订购55.11应用下载65.11.1立即下载65.11.2闲时下载65.11.3下载管理65.12应用安装(推荐)65.13参数设置65.13.1显示设置65.13.2下载设置75.13.3主题设置75.14信息上报75.15广告（可选）75.16测量统计（可选）75.17系统通知85.18关于和帮助85.19M-Market客户端安全85.19.1软件认证85.19.2版权保护85.19.3文件完整性保护85.20客户端的生命周期85.20.1下载85.20.2本地安装85.20.3安装检测85.20.4快捷方式95.20.5客户端升级95.20.6客户端卸载95.21快捷键(推荐)95.22异常处理105.22.1网络异常处理105.22.2存储异常处理105.22.3内容异常处理106编制历史10前 言本标准对中国移动M-Market客户端需要规范的内容提出全面要求，是开发和测试M-Market客户端的依据。本标准规定了M-Market业务客户端的功能要求、安全和异常处理等内容。本标准是M-Market业务系列标准之一，该系列标准的结构、名称或预计的名称如下：序号标准编号标准名称1M-Market业务平台总体技术要求2M-Market业务平台业务规范3M-Market业务平台接口规范本标准需与M-Market业务支撑平台业务规范配套使用。本标准的附录为标准性附录，附录为资料性附录。本标准由中移号文件印发。本标准由中国移动通信集团数据部提出，集团公司技术部归口。本标准起草单位：中国移动通信有限公司研究院。本标准主要起草人：1 范围本标准规定了M-Market业务客户端的功能要求、安全和异常处理等内容，供中国移动通信集团内部和厂商共同使用，为集团公司和省公司提供业务开展的依据。本标准适用于GSM/GPRS/EDGE/TD-SCDMA网络环境。2 规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。1M-Market业务平台总体技术要求中国移动通信有限公司2M-Market业务平台接口规范中国移动通信有限公司3M-Market业务平台业务规范中国移动通信有限公司43 术语、定义和缩略语3.1 术语、定义术语/定义解释Mobile Market（M-Market）中国移动为构建适应移动互联网产业的新的商业模式，并通过建立M-Market业务平台为业务运营、合作伙伴提供全面支撑。M-Market客户端M-Market客户端是浏览和下载M-Market应用的终端软件M-Market应用经过M-Market测试认证中心测试认证后，可交付给用户使用的手机终端应用。应用是可安装、可执行的软件实体。M-Market产品在M-Market业务中定义为可面向用户进行销售的单元。由合作伙伴提供的应用，在定义相应的资费规则后，即成为在M-Market上可上架销售的产品。M-Market商品商品的是为了统计不同货架上产品的销售情况。产品在上架之后即成为商品，商品是具有货架信息的某个产品。同一产品可以同时放置到多个不同的货架上，即产生多个商品。3.2 缩略语缩略语英文全称中文含义MMM-Market中国移动应用商店WAPWireless Application Protocol无线应用协议 APApplication Provider应用提供商SPService Provider服务提供商CPContent Provider内容提供商GPRSGeneral Packet Radio Service 通用无线分组业务4 业务概念在2.5G和3G移动宽带网络环境成熟，以及手机终端智能软件平台日渐普遍的基础上，M-Market通过建立一种新的业务模式，提供开放的无线数据业务产业链，为手机用户提供体验良好、产品类型丰富的手机终端应用和数字内容服务，并促进无线数据业务和市场的发展。M-Market业务以中国移动统一的用户服务界面，定制的客户端应用管理和开发环境，向手机用户提供全过程的业务服务质量。M-Market在手机终端和互联网的渠道上建立面向消费用户的统一的产品销售门店，向用户提供数字产品展示、产品体验、产品订购、产品使用反馈的一体化服务。对于用户订购的应用或内容产品，M-Market建立通畅的数字产品递送服务，通过无线宽带网络，交付到客户端，通过客户端定制的应用管理和运行环境，保证用户的使用产品的一致体验。M-Market向用户提供的手机终端应用，是由开放产业链中的参与者提供的，包括中国移动、个人应用开发者、应用提供商AP、具有手机应用商店的终端厂家等。M-Market通过收入分成的模式，保证产业链各方的利益，从而保证产品的不断更新和丰富。5 功能要求M-Market客户端提供的功能包括：登录/注销登录、应用列表和内容获取、应用展示、查看详情、预览、应用评论/评级、搜索、应用管理、应用推荐、计费与业务订购、应用下载、应用安装、参数设置、客户端安全、客户端的生命周期和异常处理等。5.1 登录/注销登录用户使用M-Market客户端前必须先进行登录，否则用户无法使用任何功能。5.1.1 登录流程方案一：客户端通过CMWAP方式访问指定的登陆地址，服务器侧返回认证结果。当登陆失败后提示用户修改APN（针对KJAVA的CMWAP不工作的情况）。*注，登陆时应与M-Market客户端升级结合起来，上报客户端版本信息，如有新版本根据服务器指定的更新策略提示用户升级客户端。5.1.2 用户登录失败后的重试以及登录成功后的断线重连登录过程中，如果登录失败，客户端将提示用户，并询问用户是否重新登录，如果用户不希望重新登录，则直接退出客户端程序。如果登录成功后GPRS/3G网络断线，则客户端会自行尝试重连，如果一定的时间内没有重连成功，则提示用户重连失败，用户可以选择尝试重新连接或退出客户端程序。5.1.3 主动注销登录和被动退出用户在登录客户端程序之后可以选择主动注销登录。注销登录时，客户端将向M-Market平台发出退出消息，断开网络连接，并直接退出客户端。5.2 应用列表和内容获取M-Market客户端可以获取M-Market平台中所有可供使用的应用列表和内容信息，客户端和M-Market业务平台基于标准HTTP协议+XML格式进行数据交互。5.3 应用展示M-Market客户端可以将M-Market平台可供下载的应用列表展示给用户。M-Market应包括但不限于按分类、排行、特色推荐和是否免费等方式向用户展示M-Market可供下载的应用列表。所有的分类和应用列表都是从M-Market平台动态下载，包括“分类展示、特色推荐、免费应用列表，排行展示”。5.3.1 分类展示用户可以按分类查看M-Market应用列表，列表中应向用户展示所有M-Market应用的分类，并向用户提供某一分类中每一应用的应用名称、应用图标、下载资费、评级、下载次数和开发者名称等信息。用户可以按照评级、应用安装文件大小和上传时间等对应用列表进行排序。M-Market客户端推荐支持多级分类列表。5.3.2 特色推荐用户可以通过M-Market客户端查看运营商向用户特色推荐的应用列表，列表中应向用户展示每一应用的应用名称、应用图标、下载资费、评级、下载次数和开发者名称等信息。用户可以按照评级、应用安装文件大小和上传时间等对应用列表进行排序。5.3.3 免费应用列表用户可以通过M-Market客户端查看免费的应用列表。列表中应向用户展示每一应用的应用名称、应用图标、下载资费、评级、下载次数和开发者名称等信息。用户可以按照评级、应用安装文件大小和上传时间等对应用列表进行排序。5.3.4 排行展示用户可以通过M-Market客户端查看按照下载次数进行排行的应用列表。列表中应向用户展示每一应用的应用名称、下载资费、评级、下载次数和开发者名称等信息。用户可以按照评级、应用安装文件大小和上传时间等对应用列表进行排序。5.4 查看详情用户可以通过M-Market客户端查看应用的详细信息。用户通过客户端选中某一应用，可以查看应用详情。详情包括但不限于缩略图、应用名称、应用提供商、应用星级、应用大小、应用资费、应用简介等信息。在M-Market应用已有用户评论情况下，用户可以通过客户端看到应用的所有评论。5.5 预览用户可以通过M-Market客户端查看应用的预览图。用户在应用详情界面选中预览，可以查看应用的预览图。用户通过查看应用的预览图可以预览应用的使用界面。5.5.1 预览图格式预览图应采用GIF格式的多帧动画，图片大小应不低于屏幕的85%。5.6 应用评论/评级用户可以通过M-Market客户端对购买的应用进行评论和评级。M-Market客户端应提供包括但不限于如下的应用评论功能。l 应用评论：用户可方便地对M-Market应用进行评论、评级，评级限定为05级，级别越高，代表应用评级越好。l 评论上传：M-Market客户端应及时将用户的评论/评级上传到M-Market平台中。l 评论查看：用户可查看M-Market应用的评论列表和评论内容以及应用的评级。5.7 搜索M-Market客户端应支持搜索M-Market平台中所有应用的功能，应支持按文件名称、开发者名称、应用描述等关键字进行搜索。搜索选项应包括但不仅限于如下选项：星级、资费、上传时间等。M-Market客户端会将用户所提交的搜索请求发送到M-Market，并将M-Market平台返回的搜索结果列表展示给用户。5.8 应用管理5.8.1 购买的应用的管理M-Market客户端应向用户提供该用户已购买的应用列表，列表中应向用户展示已经购买的应用的应用名称、应用图标、应用提供者、应用购买时间、综合评级等信息。M-Market客户端支持按照应用的应用名称和购买时间等对购买应用列表进行重新排序。5.8.2 下载的应用管理M-Market客户端应向用户提供已下载的应用列表。列表应向用户展示应用名称、应用图标、应用提供者、应用安装文件大小以及是否已安装等信息。M-Market客户端支持按照应用的应用名称、应用安装文件大小和下载时间等对下载应用列表进行重新排序。M-Market客户端应允许用户对下载应用列表中的应用条目进行删除，同时删除对应的物理文件。5.9 应用推荐M-Market客户端应支持应用推荐以及调用本地通讯录功能。用户可以直接通过M-Market客户端将M-Market应用的推荐信息发送给其他用户。接收到推荐消息的M-Market客户端应在明显位置通过闪烁等方式提醒用户有新的推荐信息，并可以向用户展示详细的推荐信息。如果接收用户未开启M-Market客户端，M-Market平台将通过短信形式向接收用户发送提示。推荐时M-Market客户端将推荐消息发送到M-Market平台，MM平台根据被推荐用户是否安装MM客户端、以及终端类型，向用户推送不同的内容。推荐消息中的源发送者号码是推荐者的号码。具体示例如下：如果被推荐者安装有MM客户端，则被推荐者通过MM客户端登陆后客户端从服务器获取推荐消息并提示用户推荐信息；如果被推荐者未安装MM客户端，则平台向被推荐者发送推荐短消息，内容包括推荐的应用名称、下载此应用所需的MM客户端下载地址，源发送者号码为推荐者号码。5.10 计费与业务订购对于M-Market业务中体验式计费的应用，M-Market客户端不涉及计费。对于M-Market业务中下载计费的MM应用，M-Market客户端与中国移动提供的计费插件交互完成下载计费。5.11 应用下载M-Market客户端应提供应用下载和下载管理功能。5.11.1 立即下载M-Market客户端应提供立即下载功能。通过立即下载，用户可以将下载任务立刻加入到下载列表并进行下载。5.11.2 闲时下载M-Market客户端应提供闲时下载功能。闲时是指网络闲时。通过闲时下载，M-Market客户端将会在24小时内的网络闲时收到M-Market平台推送的应用，推送完成后客户端会提示用户应用下载完成。* Java如果实现有困难暂时不提供。5.11.3 下载管理M-Market客户端支持展示正在下载的任务列表。客户端支持同时多个任务下载，断点续传，下载进度，闲时以及下载任务的删除、暂停和恢复；下载进度显示包括进度条、下载百分比、总字节数、已下载字节数、下载速度等。M-Market客户端下载的应用统一保存在手机指定的文件目录中。5.12 应用安装M-Market客户端应提供包括但不限于如下两种方式之一的MM应用安装功能。l 自动安装：下载完成后，无须用户干预自动完成安装l 手动安装：下载完成后，由用户手动选择是否安装M-Market客户端应启动MM应用所对应的安装管理程序对其进行安装。5.13 应用升级(推荐)M-Market客户端每次启动后检查通过M-Market客户端安装的应用是否存在更新版本，如有更新版本则提示用户更新。更新规则应遵循各个M-Market应用的更新规则，更新文件应从M-Market业务平台获取。5.14 参数设置M-Market客户端支持参数设置功能，包括但不限于显示设置、下载设置和主题设置。5.14.1 显示设置M-Market客户端应支持配置显示设置参数，并按照该设置进行客户端显示。显示设置包括但不限于如下设置。l 字体大小：范围为830l 字体行距：范围为195.14.2 下载设置M-Market客户端应支持配置下载设置参数，并按照该设置进行下载管理。下载设置包括：l 同时下载任务数：范围为15l 任务开始提示：范围为”关闭提示”、”询问下载”，默认为”关闭提示”l 任务完成提示：范围为”关闭提示”、”提示完成”、”询问打开”，默认为”关闭提示”l 下载历史记录：范围为”20”、”50”、”80”，默认为” 50”l 下载默认路径: 如果用户有存储卡，范围为”存储卡”和”手机”，默认为”存储卡”；如果用户无存储卡，范围为”手机”，默认为”手机”；如果用户从有存储卡状态变更为无存储卡状态，则客户端应自动调整为无存储卡的处理模式。5.14.3 主题设置M-Market客户端应支持配置主题模式设置，客户端应提供多套主题供用户选择，主题应美观大方；主题更换应提供包括但不限于背景颜色、文字颜色和焦点颜色的变更。5.15 信息上报M-Market客户端应向M-Market平台上报包括但不限于终端UA信息、客户端版本和支持的能力等信息，以便M-Market业务平台进行应用下载适配和下载统计。5.16 广告（可选）M-Market客户端应提供包括但不限于如下的广告功能，l 与终端广告引擎交互获取广告信息并在客户端中展示l 与M-Market平台交互获取广告信息并在客户端中展示l 客户端广告功能可以通过配置方式打开或关闭l 以用户能接收的适当的方式向用户展示注：详细的广告功能参考广告业务相关规范。5.17 测量统计（可选）M-Market客户端应提供包括但不限于如下的统计功能，l 基于指定策略统计用户行为信息l 行为信息上传l 测量统计功能可通过配置功能打开或者关闭注：如果不实现测量统计功能则在架构上考虑对测量统计功能的扩展。5.18 系统通知客户端支持接收M-Market平台下发系统通知，支持在明显位置通过闪烁等方式提醒用户有新的系统通知，支持用户查看系统通知详细信息。5.19 关于和帮助客户端应提供包括但不限于版本信息、提供者信息和帮助信息等。5.20 M-Market客户端安全M-Market客户端支持按照M-Market安全方案提供但不限于认证、版权保护以及完整性保护功能。5.20.1 软件认证M-Market客户端应支持认证软件来源，识别软件是否经过CMCC测试认证通过。5.20.2 版权保护M-Market客户端可以防止用户非法复制和安装M-Market应用安装文件。5.20.3 文件完整性保护M-Market客户端支持应用安装文件的文件完整性保护。5.21 客户端的生命周期5.21.1 下载M-Market客户端软件可以以预制方式内置在手机上，或者通过WAP、WWW方式下载。用户也可以通过PC下载后通过红外/蓝牙/数据线接口及SD卡的方式传送到手机。5.21.2 本地安装对于没有预装M-Market客户端的终端，用户下载完安装程序后，选中安装程序，按“确定”键执行安装操作。5.21.3 安装检测程序安装之前，应该检测是否已安装M-Market客户端软件。如果已安装，则需给用户一定的提示，由用户自行选择是否继续安装。程序安装之前，应该检测是否已有M-Market客户端软件在运行，如果有正在运行，则提示用户首先退出正在运行的M-Market客户端软件，然后继续安装。5.21.4 快捷方式程序安装完以后，在应用程序菜单中会出现相应的快捷方式。用户选中该快捷方式后，点击“确定”键，客户端运行。5.21.5 客户端升级5.21.5.1 手动升级M-Market客户端必须提供用户在线手动升级的能力。用户确认升级后，客户端应能从M-Market业务平台下载最新版本的M-Market客户端，并提醒用户进行安装。5.21.5.2 自动升级推荐M-Market客户端支持自动升级，客户端每次启动进行初始化时，上报当前版本信息，如果M-Market平台有新的客户端版本发布，提示用户是否进行升级。如果新版本安装完成后需要重启，客户端应给用户明确提示。M-Market客户端根据M-Market平台的指示，决定是否强制用户进行升级。强制升级是指不升级的客户端将不能正常使用。5.21.6 客户端卸载非预装的M-Market客户端软件应支持卸载功能。用户选择卸载时，可将M-Market客户端软件从终端中移除。预装的M-Market客户端软件支持升级不支持卸载。客户端卸载时向平台侧发送卸载通知，平台侧更新用户客户端状态。5.22 快捷键(推荐)M-Market客户端应提供常用快捷键，如l 1 向上翻页l 2 向上l 3 到页首l 4 向左l 5 查看消息l 6 向右l 7 向下翻页l 8 向下l 9 到页尾l 0 返回主界面l * 刷新页面*对于不同类型的终端请参考界面规范。5.23 异常处理5.23.1 网络异常处理当客户端被打开时，如果由于网络原因M-Market客户端不能与服务器正常通信，M-Market客户端应提示用户网络异常。当客户端已经以正常方式登录后，如果由于网络原因M-Market客户端不能及时更新应用列表时时，应提示用户网络异常。当客户端已经在线使用时，如果由于网络原因M-Market客户端不能与服务器正常通信，M-Market客户端应在30秒后给出提示，并提供重新加载与退出的功能。5.23.2 存储异常处理M-Market客户端在下载应用文件之前，应检测存储空间，当空间不足时提醒用户。5.23.3 内容异常处理应用安装文件异常时，M-Market客户端应可处理该异常，如屏蔽该异常，并提示用户。6 编制历史版本日期主要修改内容1.0.02009年3月初稿1.1.02009年3月初稿1.2.02009年3月更新稿