四川移动无线音乐轻量级SDKforAndroid开发者使用指南 2.0.doc

:2014年01月17日导入SDK所需的jar包下载最新版的SDK的zip包,将其中的jar包解压到本地工程的libs子目录下。Eclipse用户右键工程根目录,选择Properties->JavaBuildPath->Libraries,然后点击AddExternalJARs... 选择指向jar的路径,点击OK,即导入成功。注意:EclipseADT17以上版本用户,请在工程目录下建一个文件夹libs,把jar包直接拷贝到这个文件夹下,再在Eclipse里面刷新一下工程就好了。不要通过上述步骤手动添加jar包引用。,添加SDK需要的权限到<manifest>标签下:,添加<meta-data>标签:请您将在网站上申请的appid替换掉“appid:”之后your_appid。注意:保留value中的“appid:”举例:开发者A将申请的appid写入配置文件后,签名好应用成apk包(测试环境的apk),并提交该应用apk包到网站进行替换appkey的操作后生成正式可发布的应用apk包(生产环境的apk),该appid就不能继续在开发测试环境下使用;如果开发者要需要修改更新应用则需要重新申请appid。<String,String>initCmmEnv(ContextmContext)1、适用范围:对于单SIM手机和SDK已经支撑的双SIM卡手机SDK已经支撑的双卡手机有金立、亿城、承开、华为。都适用;2、请求参数:字段必选类型说明mContexttrueContext上下文3、响应参数:类型说明Hashtable<String,String>key:code-返回码value:desc-与code对应的返回描述如:“0”:“初始化成功”“1”:“手机号和IMSI关系未找到”“2”:“请检查网络连接”“3”:“请使用中国移动SIM卡”“4”:“无SIM卡“5”:“初始化函数调用间隔不能小于30s“6”:“在24小时内短信初始化调用次数不能超过3次。“11”:“WAP获取手机号失败”“12”:“无效的wap初始化IP”“13”:“IMSI存在于黑名单中”“14”:“数据库异常”“15”:“双卡槽初始化都失败(可从detail字段查询每个卡槽失败的code)”“16”:“您有两张移动SIM卡,请选择其中一张进行初始化!”“-1”:“未知错误”“-2”:“connectiontimeoutandsoon(网络不通,初始化失败稍后重试)”特别说明:双卡初始时添加一个字段key:detailValue:n1n2解释value的值:n1是卡槽1返回的code值,n2是卡槽2返回的code值。应用启动时必须要调用初始化方法initCmmEnv,用于初始化,获取初始化信息。对于SDK已经支持的双SIM卡手机1,如果两个卡只有一个是移动的SIM卡,初始化程序将初始化移动卡,如果两个都不是移动的SIM卡或都是移动卡,则会返回错误提示;(ContextmContext)1、适用范围:对于单SIM手机和SDK已支撑的双SIM卡手机1都适用;2、请求参数:字段必选类型说明mContexttrueContext上下文3、响应参数:类型说明booleantrue:有对应关系false:没有对应关系initCheck检查初始化状态,返回true表示初始化成功,返回false则表示尚未初始化或初始化未成功。由于初始化接口内部包含了初始化检查,所以建议在每次启动应用时执行初始化接口,初始化状态检查方法用于检查应用是否初始化成功但并不是必须的。特别注意:Sms/wap初始化应该作为优先的初始化方式;由于初始化的过程中需要获取一些必要的参数和做必要的安全验证,因此耗时稍长,建议开发者在非UI线程中执行;为提升应用的用户体验,建议应用开发者可以在应用启动时直接进入应用,同时在异步线程中执行sms/wap初始化,正常状态下初始化时间在15s以内,因个别机型配置偏低、网络状况不稳定、短信拦截软件(安全卫士360等)等原因初始化时间可能会达到30s左右或失败请开发者在初始化和能力调用时判断是否有网络链接,sim卡是否为中国移动业务。强调一点,sms/wap初始化接口不能反复调用!如果初始化失败请及时向