由于现在腾讯微博提供的java(android) sdk功能过弱,自己搞了个java sdk包,同样适用于android。包含腾讯微博目前提供的95%的api,几乎所有主要功能api,用法简单(微博、评论、转发、私信同一个实体类),方便扩展(可以根据自己需要修改源代码或是继承QqTSdkService类,当然为了后续依然能升级版本建议采用继承的方式)。
下面介绍源码地址和jar包地址,然后介绍api的具体使用
1、源码和jar包下载
QqTAndroidSdk-1.0.0.jar为sdk主代码,其中的QqTSdkServiceImpl包含了所有接口的实现,下面第二部分对此中接口进行介绍
jar包地址:QqTAndroidSdk-1.0.0.jar
google code源码地址:http://code.google.com/p/qq-t-java-sdk/source/browse/
github源码地址:https://github.com/Trinea/qq-t-java-sdk
JavaCommon-1.0.0.jar为QqTAndroidSdk依赖的公用处理包,包含字符串、list、数组、map、json工具类等等
jar包地址:已经包含在QqTAndroidSdk-1.0.0.jar中
google code源码地址:http://code.google.com/p/trinea-java-common/source/browse/
github源码地址:https://github.com/Trinea/JavaCommon
2、具体使用
参数同腾讯微博api http://wiki.open.t.qq.com/index.php/API%E6%96%87%E6%A1%A3
注意:以下所有的api示例代码都需要先新建QqTSdkService类对象并初始化,初始化如下
/**
* 分别设置应用的key、secret(腾讯提供)。用户的accesstoken和tokenSecret(OAuth获取)
* 请用自己的相应字符串替换,否则无法成功发送和获取数据
**/
QqTAppAndToken qqTAppAndToken = new QqTAppAndToken();
qqTAppAndToken.setAppKey("***"); // ***用应用key替换
qqTAppAndToken.setAppSecret("***"); // ***用应用secret替换
qqTAppAndToken.setAccessToken("***"); // ***用用户accesstoken替换
qqTAppAndToken.setTokenSecret("***"); // ***用用户tokenSecret替换
/** 新建QqTSdkService对象,并设置应用信息和用户访问信息 **/
QqTSdkService qqTSdkService = new QqTSdkServiceImpl();
qqTSdkService.setQqTAppAndToken(qqTAppAndToken);
关于以上的accessToken及tokenSecret的获取请见OAuth认证介绍及腾讯微博OAuth认证示例
下面就对接口进行介绍,并举例如何使用QqTAndroidSdk-1.0.0.jar中的api,每个接口都有三种返回参数,可以满足不同需求,接口主要分成几大类:
2.1、时间线(微博列表)
这20个接口包含了腾讯微博四部分api
1.1、时间线中的除statuses/ht_timeline_ext(话题时间线)以外的15个api
1.2、私信相关中的收件箱、发件箱两个api
1.3、数据收藏中的收藏的微博列表和获取已订阅话题列表两个api
1.4、微博相关中的获取单条微博的转发或点评列表api
以获取首页信息为例,示例代码如下:
QqTTimelinePara qqTTimelinePara = new QqTTimelinePara();
/** 设置分页标识 **/
qqTTimelinePara.setPageFlag(0);
/** 设置起始时间 **/
qqTTimelinePara.setPageTime(0);
/** 每次请求记录的条数 **/
qqTTimelinePara.setPageReqNum(QqTConstant.VALUE_PAGE_REQ_NUM);
/** 可以设置拉取类型,可取值QqTConstant中VALUE_STATUS_TYPE_TL_… **/
qqTTimelinePara.setStatusType(QqTConstant.VALUE_STATUS_TYPE_TL_ALL);
/** 可以设置微博内容类型,可取值QqTConstant中VALUE_CONTENT_TYPE_TL… **/
qqTTimelinePara.setContentType(QqTConstant.VALUE_CONTENT_TYPE_TL_ALL);
List<QqTStatus> qqTStatusList = qqTSdkService.getHomeTL(qqTTimelinePara);
assertTrue(qqTStatusList != null);
这样qqTStatusList就保存了首页的20条数据,可以自己设置不同的类型参数
更多时间线数据获取见:腾讯微博java(android)sdk时间线api详细介绍
2.2、新增微博api
8个接口包含了
2.1、微博相关中的发表一条微博、转播一条微博、回复一条微博、发表一条带图片微博、点评一条微博、发表音乐微博、发表视频微博、发表心情帖子。在api中发表一条微博和发表一条带图片微博合二为一。
2.2、私信相关中的发私信api
以新增一条微博为例,示例代码如下
qqTSdkService.addStatus("第一条状态哦", null);
其找第一个参数为状态内容,第二个参数为图片地址,不传图片为空即可
或者复杂点的如下,status可以设置其他地理位置信息等
QqTStatusInfoPara status = new QqTStatusInfoPara();
status.setStatusContent("发表一条带图片微博啦");
/** 发表带图微博,设置图片路径 **/
status.setImageFilePath("/mnt/sdcard/DCIM/Camera/IMAG2150.jpg");
assertTrue(qqTSdkService.addStatus(status, qqTAppAndToken));
更多新增微博api介绍见:腾讯微博java(android)sdk新增微博api详细介绍
2.3、操作一条微博
这6个接口包含了腾讯微博三部分api
1.1、微博相关中的删除一条微博api。
1.2、私信相关中的删除私信api
1.3、数据收藏中收藏微博、取消收藏微博、订阅话题、取消订阅话题4个api
以收藏一条微博为例,示例代码如下
qqTSdkService.collect(12121);
其中参数为微博id
更多操作微博相关api介绍见: 腾讯微博java(android)sdk操作(删除.收藏.订阅等)微博api详细介绍
2.4、关系链列表(用户列表)
这10个接口包含了腾讯微博关系链相关中的互听关系链列表(对某个用户而言,既是他的听众又被他收听)、其他帐号听众列表、其他帐号收听的人列表、其他帐户特别收听的人列表、黑名单列表、我的听众列表、我的听众列表(只包含名字)、我收听的人列表、我收听的人列表(只包含名字)、我的特别收听列表10个api
以获取自己的收听用户为例,示例代码如下
QqTUserRelationPara qqTUserRelationPara = new QqTUserRelationPara();
qqTUserRelationPara.setReqNumber(QqTConstant.VALUE_PAGE_REQ_NUM);
qqTUserRelationPara.setStartIndex(0);
List<QqTUser> qqTUserList = qqTSdkService.getSelfInterested(qqTUserRelationPara);
2.5、用户建立关系
这6个接口包含了腾讯微博关系链相关中的收听某个用户、取消收听某个用户、特别收听某个用户、取消特别收听某个用户、添加某个用户到黑名单、从黑名单中删除某个用户共6个api
以关注某些用户为例,示例代码如下:
qqTSdkService.interestedInOther("wenzhang,li_nian,mayili007", null)
更多用户建立关系相关api介绍见:
腾讯微博java(android)sdk用户建立关系api详细介绍
2.6、帐户相关
这7个接口包含了腾讯微博帐户相关中的获取自己的详细资料、更新用户信息、更新用户头像信息、更新用户教育信息、获取其他人资料、获取一批人的简单资料、验证账户是否合法(是否注册微博)共7个api。除获取心情微博api外
以获取自己的资料为例,示例代码如下:
QqTUser qqTUser = qqTSdkService.getSelfInfo();
更多帐户相关api介绍见:腾讯微博java(android) sdk 帐户相关api详细介绍
2.7 搜索相关
这3个接口包含了腾讯微博搜索相关中的搜索用户、搜索微博、通过标签搜索用户共3个api。
以搜索微博为例,示例代码如下:
public void testSearchStatus() {
QqTSearchPara qqTSearchPara = new QqTSearchPara();
qqTSearchPara.setKeyword("iphone");
qqTSearchPara.setPage(1);
qqTSearchPara.setPageSize(QqTConstant.VALUE_PAGE_REQ_NUM);
List<QqTStatus> qqTStatusList = qqTSdkService.searchStatus(qqTSearchPara);
assertTrue(qqTStatusList != null);
}
更多搜索相关api介绍见:
腾讯微博java(android) sdk 搜索相关api详细介绍
2.8 热度趋势相关
这2个接口包含了腾讯微博热度趋势中的话题热榜、转播热榜用户共2个api。
以话题热榜为例,示例代码如下:
public void testGetHotTopics() {
QqTHotStatusPara qqTHotStatusPara = new QqTHotStatusPara();
qqTHotStatusPara.setReqNum(QqTConstant.VALUE_PAGE_REQ_NUM);
qqTHotStatusPara.setLastPosition(0);
/**
* 1 话题名,2 搜索关键字 3 两种类型都有
**/
qqTHotStatusPara.setType(Integer.toString(1));
List<QqTTopicSimple> hotTopicsList = qqTSdkService.getHotTopics(qqTHotStatusPara);
assertTrue(hotTopicsList != null);
}
更多热度趋势相关api介绍见:腾讯微博java(android) sdk 热度趋势相关api详细介绍
2.9 数据更新相关
这1个接口为腾讯微博数据更新相关中的查看数据更新条数api。
示例代码如下:
public void testGetUpdateInfoNum() {
/** 设置clearType,对应QqTConstant.VALUE_CLEAR_TYPE_… **/
QqTUpdateNumInfo qqTUpdateNumInfo = qqTSdkService.getUpdateInfoNum(true, QqTConstant.VALUE_CLEAR_TYPE_HOME_PAGE);
assertTrue(qqTUpdateNumInfo != null);
}
更多数据更新相关api介绍见:腾讯微博java(android) sdk 数据更新相关api详细介绍
2.10 话题相关
这2个接口为腾讯微博话题相关中的根据话题名称查询话题id和根据话题id获取话题相关信息api。
示例代码如下:
public void testGetTopicInfoByIds() {
/** 先得到话题id **/
Map<String, String> topicIdAndName = qqTSdkService.getTopicIdByNames("袁莉闪婚,美汁源下架,iphone");
if (topicIdAndName != null) {
/** 话题id列表,以逗号分隔 **/
List<QqTStatus> qqtStatusList = qqTSdkService.getTopicInfoByIds(ListUtils.join(new ArrayList<String>(topicIdAndName.keySet())));
assertTrue(qqtStatusList != null);
} else {
assertTrue(false);
}
}
以上代码为先根据话题名得到话题id列表,然后为根据话题id获取话题相关信息接口,参数为话题id列表,以逗号分隔
更多话题相关api介绍见:腾讯微博java(android) sdk 话题相关api详细介绍
2.11 标签相关
这2个接口为腾讯微博标签相关中的添加标签和删除标签api。
public void testDeleteTag() {
/** 删除自己的tag,先获取自己的资料,从中取中tag id **/
QqTUser qqTUser = qqTSdkService.getSelfInfo();
if (qqTUser != null && qqTUser.getTagMap() != null && qqTUser.getTagMap().size() > 0) {
/** 删除tag **/
for (Map.Entry<String, String> tag : qqTUser.getTagMap().entrySet()) {
qqTSdkService.deleteTag(tag.getKey());
}
} else {
assertTrue(false);
}
}
更多标签相关api介绍见:腾讯微博java(android) sdk 标签相关api详细介绍
你可能还感兴趣:
Android公共库(缓存 下拉ListView 下载管理Pro 静默安装 root运行 Java公共类)
Android系统下载管理DownloadManager功能介绍及使用示例