腾讯微博java(android)sdk用户建立关系api详细引见
本文主要介绍腾讯微博android sdk中用户建立关系有关的6个接口,以及使用的示例代码:
注意:以下所有的api示例代码都需要先新建QqTSdkService类对象qqTSdkService并初始化,见sdk使用总介绍
1、6个接口介绍
这6个接口包含了腾讯微博关系链相关中的收听某个用户、取消收听某个用户、特别收听某个用户、取消特别收听某个用户、添加某个用户到黑名单、从黑名单中删除某个用户共6个api
对应函数图如下(其中relationWithOtherCommon为公用函数):
以上都根据userName和userOpenId建立或取消关系,至少有一个不为空,若同时存在则以userName值为主
由于收听用户可以批量收听,故独立出来,userNames 用户名帐户名列表,若多个则用","隔开,userOpenIds 用户openid列表,若多个则用"_"隔开 当前用户及应用信息
2、示例代码
由于这6个接口类似,以取消收听某个用户(interestedInOther)、
收听某些用户(interestedInOther)、
把用户加入黑名单(addOtherToBlackList)为例
2.1 函数形式
这6个接口同样都有三种返回结果即字符串、boolean、QqTResponse,可根据需要调用。
以取消收听某个用户(cancelInterestedInOther)为例
public String cancelInterestedInOther(String format, String userName, String userOpenId); public boolean cancelInterestedInOther(String userName, String userOpenId); public QqTResponse cancelInterestedInOtherRes(String userName, String userOpenId);
String cancelInterestedInOther返回整个结果的字符串,可以通过format定义以xml还是json形式返回
boolean cancelInterestedInOther返回是否操作成功
QqTResponse cancelInterestedInOtherRes返回QqTResponse,QqTResponse是先得到json串的结果,然后转换为QqTResponse对象
其他用户建立关系api类似
2.2 参数意义
对于各参数意义同腾讯微博关系链api参数,
根据userName和userOpenId建立或取消关系,至少有一个不为空,若同时存在则以userName值为主
收听用户比较特殊,可以批量收听,其中userNames 用户名帐户名列表,若多个则用","隔开,userOpenIds 用户openid列表,若多个则用"_"隔开
2.3、不同返回结果调用示例
2.3.1 字符串形式返回
public void testCancelInterestedInOtherStr() { assertTrue(qqTSdkService.cancelInterestedInOther(QqTConstant.VALUE_FORMAT_XML, "wenzhang", null) != null); }
取消关注wenzhang
2.3.2 boolean返回
public void testInterestedInOther() { assertTrue(qqTSdkService.interestedInOther("wenzhang,li_nian,mayili007", null)); }
同时关注wenzhang、li_nian、mayili007
2.3.3 QqTResponse形式返回
public void testAddOtherToBlackListRes() { assertTrue(qqTSdkService.addOtherToBlackListRes("mayili007", null) != null); }
将mayili007加入很名单
整个sdk api使用见:http://trinea.iteye.com/blog/1299505