腾讯微博java(android)sdk用户建立关系api详细引见

腾讯微博java(android)sdk用户建立关系api详细介绍

本文主要介绍腾讯微博android sdk中用户建立关系有关的6个接口,以及使用的示例代码

注意:以下所有的api示例代码都需要先新建QqTSdkService类对象qqTSdkService并初始化,见sdk使用总介绍


1、6个接口介绍

这6个接口包含了腾讯微博关系链相关中的收听某个用户、取消收听某个用户、特别收听某个用户、取消特别收听某个用户、添加某个用户到黑名单、从黑名单中删除某个用户共6个api

对应函数图如下(其中relationWithOtherCommon为公用函数):

腾讯微博java(android)sdk用户建立关系api详细引见

以上都根据userName和userOpenId建立或取消关系,至少有一个不为空,若同时存在则以userName值为主 
由于收听用户可以批量收听,故独立出来,userNames 用户名帐户名列表,若多个则用","隔开,userOpenIds 用户openid列表,若多个则用"_"隔开 当前用户及应用信息

腾讯微博java(android)sdk用户建立关系api详细引见

2、示例代码

由于这6个接口类似,以取消收听某个用户(interestedInOther)、

收听某些用户(interestedInOther)

把用户加入黑名单(addOtherToBlackList)为例

 

2.1  函数形式

这6个接口同样都有三种返回结果即字符串、booleanQqTResponse,可根据需要调用

以取消收听某个用户(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