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

四川移动无线音乐轻量级sdkforandroid开发者使用指南_2.0四川移动无线音乐轻量级SDK for
更新时间:2014年01月17日
导入SDK所需的jar包
下载最新版的SDK的zip包,将其中的jar包解压到本地工程的libs子目录下。
Eclipse用户右键工程根目录,选择Properties -> Java Build Path -> Libraries,然后点击Add External JARs... 选择指向jar的路径,点击OK,即导入成功。
注意:
Eclipse ADT 17 以上版本用户,请在工程目录下建一个文件夹libs,把jar包直接拷贝到这个文件夹下,再在Eclipse里面刷新一下工程就好了。不要通过上述步骤手动添加jar包引用。详情请参考Dealing with dependencies in Android projects.
添加权限
,添加SDK需要的权限到<manifest>标签下:
添加appid
,添加<meta-data>标签:
请您将在网站上申请的appid替换掉“appid:”之后your_appid。
注意:保留value中的“appid:”
举例:
开发者A将申请的appid写入配置文件后,签名好应用成apk包(测试环境的apk),并提交该应用apk包到网站进行替换appkey的操作后生成正式可发布的应用apk包(生产环境的apk),该appid就不能继续在开发测试环境下使用;如果开发者要需要修改更新应用则需要重新申请appid。
初始化InitCmmInterface

public static Hashtable<String, String>initCmmEnv(Context mContext)
1、适用范围:对于单SIM手机和SDK已经支撑的双SIM卡手机 SDK已经支撑的双卡手机有金立、亿城、承开、华为。
都适用;
2、请求参数:
字段
必选
类型
说明
mContext
true
Context
上下文
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”:“connection timeout and so on(网络不通,初始化失败稍后重试)”
特别说明:双卡初始时添加一个字段
key: detail
Value:n1 n2
解释value的值:n1是卡槽1返回的code值,n2是卡槽2返回的code值。
应用启动时必须要调用初始化方法initCmmEnv,用于初始化,获取初始化信息。
对于SDK已经支持的双SIM卡手机1,如果两个卡只有一个是移动的SIM卡,初始化程序将初始化移动卡,如果两个都不是移动的SIM卡或都是移动卡,则会返回错误提示;

public static booleaninitCheck(Context mContext)
1、适用范围:对于单SIM手机和SDK已支撑的双SIM卡手机1都适用;
2、请求参数:
字段
必选
类型
说明
mContext
true
Context
上下文
3、响应参数:
类型
说明
boolean
true:有对应关系
false:没有对应关系
initCheck检查初始化状态,返回true表示初始化成功,返回false则表示尚未初始化或初始化未成功。
由于初始化接口内部包含了初始化检查,所以建议在每次启动应用时执行初始化接口,初始化状态检查方法用于检查应用是否初始化成功但并不是必须的。
特别注意:
Sms/wap初始化应该作为优先的初始化方式;
由于初始化的过程中需要获取一些必要的参数和做必要的安全验证,因此耗时稍长,建议开发者在非UI线程中执行;
为