中国移动MMAPI用户手册模板.doc
《中国移动MMAPI用户手册模板.doc》由会员分享,可在线阅读,更多相关《中国移动MMAPI用户手册模板.doc(36页珍藏版)》请在咨信网上搜索。
1、中国移动MM7 API用户手册版本:V1.5.3 中国移动集团企业修改统计文件编号版本号拟制人/修改人拟制/修改日期更改理由关键更改内容(写关键点即可)V1.1胡冬梅.03.22修改、整理V1.2胡冬梅.04.14增加内容增加安装说明V1.3胡冬梅.4.21增加内容增加状态码等说明 V1.5.1胡冬梅.5.12增加内容增加获取API版本信息、API返回码说明等目 录1.概述52.概念52.1企业代码52.2服务代码62.3业务代码62.3.1上行业务业务代码规范62.3.2下行业务业务代码规范82.4操作指令码102.5下行业务112.6上行业务112.7递送汇报113.安装方法113.1 M
2、M7 API使用113.2配置文件设置114.开发方法134.1 VASP接收传送请求(上行业务)134.1.1 方法1:一般应用程序中使用方法134.1.2 方法2:Web应用程序中使用方法144.2发送多媒体消息过程(下行业务)154.2.1准备154.2.2创建待发送消息164.2.2.1 创建提交增值业务多媒体消息(MM7SubmitReq)164.2.2.2 创建取消多媒体消息(MM7CancelReq)184.2.2.3 创建替换多媒体消息(MM7ReplaceReq)184.2.3 创建消息内容体194.2.4 发送多媒体消息204.2.5发送MM7SubmitReq消息到移动终
3、端实例204.3 VASP接收传送消息和发送提交消息实例214.4 VASP接收状态汇报(上行业务)244.4.1方法1:一般应用程序中使用方法244.4.2方法2:Web应用程序中使用方法254.5 VASP接收读后回复汇报(上行业务)264.5.1方法1:一般应用程序中使用方法264.5.2方法2:Web应用程序中使用方法274.6 发送取消消息(下行业务)274.7 发送替换消息(下行业务)285.开发过程中需用部分Status解释295.1 相关VASP接收到消息后设置返回响应(Res)状态码及状态汇报解释295.2 相关VASP收到DeliverReq中MMStatus解释305.3
4、 相关VASP收到ReadReplyReq中ReadStatus解释306.获取MM7 API版本信息方法307. MM7 API返回StatusCode说明301.概述该文档说明了SP怎样使用中国移动集团企业MM7 API程序和彩信中心进行对接,实现MM7接口通讯,开发增值业务应用。该MM7 API是使用纯Java开发,使用JDK版本为JDK1.4.0。所以使用该API进行开发时,要求使用JDK版本必需是JDK1.4.0以上版本。该API所使用通讯承载协议是HTTP/1.1。缩略词: MM: Multimedia Message (多媒体消息) MMS: Multimedia Message
5、 Service(多媒体消息服务) MMSC: Multimedia Message Service Center(多媒体消息服务中心) VAS: Value Added Service(增值业务) SP: Service Provider(业务提供商) HTTP: Hypertext Transfer Protocol(超文本传输协议)2.概念2.1企业代码企业代码是企业身份标识,网络中地址翻译、计费、结算等均以企业代码为依据。企业代码数据需要在MMSC和BOSS系统中进行配置。企业代码以数字表示,共6位,从“8XY000”至“8XY999”,其中“XY”为各移动分企业代码。彩信全网业务SP
6、企业代码为8XY0018XY999。(现在短信全网业务企业代码为9XY0019XY500,WAP全网业务企业代码为9XY5019XY999。)彩信地方业务SP企业代码由各地方移动企业根据业务许可次序依次分配制订,“XY”具体分配情况见相关表格。2.2服务代码服务代码是:用户使用彩信发送、上传等上行类业务时,需要输入接收方号码;或SP在依据用户点播请求在向用户发送、下载等下行类业务时,用户终端中显示发送方号码。服务代码数据需要在MMSC上进行配置,用于路由查找和状态汇报返回。服务代码以数字表示。全国业务服务代码长度统一为4位,即“1000”“9999”;当地业务服务代码长度统一为5位,即“010
7、00”“09999”。以下号码或号段暂不分配:13XX(XX00-99)、20XX(XX0199)、168X(X0-9)、186X(X=0-9)、1258/1259、172X(X=0-9)、6XXX、7XXX。上述代码分配和使用情况均能够在.com上查询。假如SP已经开展了短信等业务,标准上彩信服务代码依据SP原有服务代码进行分配,以确保用户使用习惯。现在全网业务服务代码,由集团企业统一分配。2.3业务代码业务代码表示业务类别,而且区分不一样业务信息服务费。业务代码数据需要在MMSC和BOSS系统中进行配置。业务代码用数字表示,而且不能使用000。为便于进行业务统计和分析,业务代码尽可能根据不
8、一样业务分类以下:互联网点播类: 以1开头 WAP点播类: 以2开头短信点播类: 以3开头 STK点播类: 以4开头彩信点播类: 以0开头业务代码在遵照标准前提下其它内容由SP自己制订。2.3.1上行业务业务代码规范上行业务业务代码为三位,其组成以下:第1位:0、7、9开头业务代码保留,其它代码由彩信SP自行编排。第23位:由彩信SP自行编排特例:假如用户直接给四位服务代码发送上行彩信,系统会默认加上业务代码“0”,该业务代码默认开通,仅用于上行彩信到服务代码。2.3.2下行业务业务代码规范下行业务业务代码为六位,其组成以下:第1位:功效标识位,现在有以下两种选择:l 1,代表通常下行业务l
9、7,代表用于“先机时代”项目中手机内置并参与渠道分成业务l 6,代表用于集团用户应用业务(无偿)其它数字现在保留。第2位:彩信业务一级分类,具体以下面表格:第3位:彩信业务二级分类,具体以下面表格:一级分类及标识代码二级分类及标识代码新闻天气(1)天气预报(1)热点快讯(2)社会新闻(3)体育新闻(4)娱乐新闻(5)财经新闻(6)综合新闻(0)游戏娱乐(2)聊天交友(1)笑话幽默(2)彩信游戏(3)影音视线(4)互动有奖(5)五花八门(0)时尚生活(3)时还有约(1)车迷世界(2)文化教育(3)情感画廊(4)爱情家庭(5)两性健康(6)证券财经(7)位置服务(8)五花八门(0)卡通动漫(4)欧
10、美(1)日本(2)韩国(3)港台(4)当地原创(5)五花八门(0)彩信铃声(5)明星专辑(1)精品影视(2)流行音乐(3)古典音乐(4)卡拉OK(5)特殊音效(6)五花八门(0)彩图动画(6)人物剪影(1)动物一族(2)漂亮心情(3)温馨祝福(4)电影名画(5)体育纵横(6)大千世界(7)3D动画(8)五花八门(0)彩信DIY(7)贺卡类(1)形象类(2)文字类(3)五花八门(0)特色用途(0)无偿客服(1)优惠套餐(2)第4位:业务模式位,各个模式及其数字标识以下:l 1:按条点播l 2:按条定制l 3:包月定制l 4:包月点播第56位:由彩信SP自行编排2.4操作指令码操作指令码是指用户经
11、过短信点播或定制彩信业务时,在短信信息体内输入代码,或用户上行发送彩信时,在彩信消息体内文本信息中输入代码。操作指令码用于标识对彩信处理方法。此代码出现在短信或彩信消息体内,由SP自行处理,彩信中心不负责处理该代码。在短信中输入操作指令码应严格区分用户是点播、定制短信业务还是彩信业务。假如用户经过短信点播或定制彩信业务,操作指令码应以CX开头。如:用户在短信或彩信文本信息体内输入“CX XW”发送至8888,就是定制新浪提供彩信图片新闻业务。2.5下行业务由SP主动提议业务。这里关键指SP向MMSC提议业务。2.6上行业务SP被动接收业务。这里关键指从MMSC那里接收业务。2.7递送汇报汇报是
12、接收方(终端)对接收到消息处理方法信息。递送汇报指MMSC在获取这个汇报后把这个信息发送给发送方(SP)。接收方对消息处理可能是接收或拒绝等。处理步骤以下:l SP发送消息(经过MMSC)给终端,而且要求递送汇报;l 终端接收到消息后做对应处理(接收或拒绝);l MMSC把终端对消息处理信息(递送汇报)发送给SP。3.安装方法 这里关键介绍一下怎样将MM7 API利用到VASP自己开发程序中和在配置文件中需要注意修改地方。3.1 MM7 API使用在VASP用Java开发自己程序时,只要将中国移动集团企业提供mm7api.jar和lib下全部Jar文件加入到classpath中即可。3.2配置
13、文件设置 配置文件mm7Config.xml需要依据SP情况进行修改。1zxmezxmec:vas_log1100120200UTF-81 /mm7192.120.231.180true192.120.231.2288050100005部分地方需要进行修改,下面一一说明:1表示VASP作为服务端接收消息时是否进行鉴权或进行什么样鉴权,0表示不鉴权,1表示进行基础鉴权,2表示进行摘要鉴权。zxmezxme表示彩信中心对VASP进行鉴权时用户名和密码,同时也是VASP对接入彩信中心进行鉴权时用户名和密码,是双向,要VASP和MMSC双方进行约定。c:vas_log表示日志存放路径,在Windows
14、操作系统下和Linux下是不一样,要注意进行修改。1表示MMSC网关序号,需要从MMSC处得到。 /mm7192.120.231.180分别表示MMSC网关URL地址和IP(或主机名),也需要MMSC处得到。这里也能够填成ip:port。比如:192.120.231.180:8080,不填端口号使用默认端口号80。192.120.231.22880表示当VASP用应用程序方法进行接收消息时监听地址和端口号。以上为这个配置文件中关键需要注意修改地方,当然其它内容也能够进行修改,如1能够依据需要进行修改,0表示不产生日志;1表示产生错误日志;3表示产生信息日志;6表示产生完整信息日志。90000表
15、示设置发送超时时间,若发送超出这个时间,则自动进行重新发送。2表示设置重发次数,提议在3次以下,通常见2次即可。4.开发方法这里关键介绍从SP接收MMSC发过来DeliverReq开始,到SP发送SubmitReq到MMSC整个步骤,SP所需要做工作。4.1 VASP接收传送请求(上行业务)VASP接收能够有两种方法:l 假如SP增值应用是一个一般应用程序,能够使用方法1,即接收代理会自动打开一个监听端口,开启一个监听线程来接收来自MMSC多媒体消息;l 假如SP增值应用是一个Web应用,则能够使用方法2,即接收代理作为一个Servlet运行,并自动处理从HttpRequest中搜索数据,并解
16、码成多媒体消息。4.1.1 方法1:一般应用程序中使用方法public class MyReceiver extends MM7Receiver/定义一个MM7DeliverReq,方便得到MMSC发过来Deliver消息。(必备)public static MM7DeliverReq deliverReq = new MM7DeliverReq();/Main方法public static void main(String args)/初始化VASPMM7Config mm7Config = new MM7Config(“./config/mm7Config.xml”);/设置ConnCon
17、fig.xml文件路径mm7Config.setConnConfigName(“./config/ConnConfig.xml”); /必备/结构MyReceiverMyReciever receiver = new MyReceiver();myReceiver.setConfig(mm7Config); /必备/创建MM7消息发送接口MM7Sender mm7Sender = new MM7Sender(mm7Config);/开启接收器receiver.start();for(;);public MM7VASPRes doDeliver(MM7DeliverReq request)/*接
18、收从MMSC发过来传送消息,方便取出其中部分值结构提交消息或得到部分有用信息,如MMSC标识符等*/deliverReq = request;System.out.println(“收到手机”+request.getSender()+“提交消息,标题为:”+request.getSubject(); System.out.println(MMSC标识符为:+request. GetMMSRelayServerID();/SP需要进行部分处理,比如构建MM7DeliverRes消息,设置ServiceCode或StatusCodeMM7DeliverRes mm7DeliverRes = new
19、 MM7DeliverRes();mm7DeliverRes.setServiceCode(服务代码); /设置ServiceCode,可选mm7DeliverRes.setStatusCode(MMConstants.RequestStatus.SUCCESS);/*设置请求完成状态,必备,方便表明SP已经接收到传送消息。通常设1000。*/mm7DeliverRes.setStatusText(所用状态文本说明); /*设置所用状态文本说明,应限定请求状态,可选*/返回给MM7 API,方便API将MM7DeliverRes返回给MMSC。return(MM7VASPRes)mm7Deli
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 中国移动 MMAPI 用户手册 模板
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【精****】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【精****】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。