开发者注册、应用创建
- 登录腾讯开放平台注册开发者账号并登录;
- 登陆后,点击右上角用户头像展开菜单,选择管理中心;
- 进入管理中心后,在安卓应用界面点击创建应用按钮,填写对应的应用信息提交审核后完成应用的创建。
注:在新建应用时,记录APP ID与APP KEY,在以后的开发过程中会用到。同时,在管理中心界面可以查看到对应应用的详细信息。
2.开发环境配置
-
SDK下载
登录资料库进行SDK的下载。 -
资源引用
新建工程包名必须与平台创建应用包名一致,将open_sdk_xxx.jar
手动导入到项目libs目录下,添加jar包后,右键选择Add As Library添加该jar包到项目的Library,如下图所示:
-
AndroidManifest.xml配置
- 在manifest标签内添加如下权限:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
- 在application标签内添加如下内容:
<!-- ############ QQ空间和QQ SSO授权的Activity注册 ############ -->
<activity
android:name="com.tencent.tauth.AuthActivity"
android:noHistory="true"
android:launchMode="singleTask" >
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="tencent你的AppId" />
</intent-filter>
</activity>
<activity
android:name="com.tencent.connect.common.AssistActivity"
android:screenOrientation="portrait"
android:theme="@android:style/Theme.Translucent.NoTitleBar" />
注意:一定记得在
<data android:scheme="tencent你的AppId" />
添加上应用的AppId(如:对应应用的AppId为123456,则应填写tencent123456
)。
3.内容分享
3.1 新建Tencent实例
private Tencent mTencent;// 新建Tencent实例用于调用分享方法
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mTencent = Tencent.createInstance("your APP ID",getApplicationContext());
}
注:在新建Tencent实例时,一定要注意填写应用的APPID,如:APPID为
123456
,使用Tencent.createInstance("123456",getApplicationContext());
即可创建Tencent实例。
-
分享回调接口的实现
自定义分享回调接口:
class MyIUiListener implements IUiListener {
@Override
public void onComplete(Object o) {
// 操作成功
}
@Override
public void onError(UiError uiError) {
// 分享异常
}
@Override
public void onCancel() {
// 取消分享
}
}
重写Activity或者Fragment的onActivityResult方法,否则不能正常的监听分享状态,具体代码如下:
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
// TODO Auto-generated method stub
super.onActivityResult(requestCode, resultCode, data);
Tencent.onActivityResultData(requestCode, resultCode, data, mIUiListener);
if (requestCode == Constants.REQUEST_API) {
if (resultCode == Constants.REQUEST_QQ_SHARE || resultCode == Constants.REQUEST_QZONE_SHARE || resultCode == Constants.REQUEST_OLD_SHARE) {
Tencent.handleResultData(data, mIUiListener);
}
}
}
3.2 分享消息到QQ
- 默认分享-图文并存
private Bundle params;
private void shareToQQ() {
params = new Bundle();
params.putInt(QQShare.SHARE_TO_QQ_KEY_TYPE,QQShare.SHARE_TO_QQ_TYPE_DEFAULT);
params.putString(QQShare.SHARE_TO_QQ_TITLE, "标题");// 标题
params.putString(QQShare.SHARE_TO_QQ_SUMMARY, "要分享的摘要");// 摘要
params.putString(QQShare.SHARE_TO_QQ_TARGET_URL,"http://www.qq.com/news/1.html");// 内容地址
params.putString(QQShare.SHARE_TO_QQ_IMAGE_URL,"http://imgcache.qq.com/qzone/space_item/pre/0/66768.gif");// 网络图片地址 params.putString(QQShare.SHARE_TO_QQ_APP_NAME, "应用名称");// 应用名称
params.putString(QQShare.SHARE_TO_QQ_EXT_INT, "其它附加功能");
// 分享操作要在主线程中完成
ThreadManager.getMainHandler().post(new Runnable() {
@Override
public void run() {
mTencent.shareToQQ(mActivity, params, mIUiListener);
}
});
}
- 分享纯图片到QQ
/**
* 分享纯图片到QQ
*
* @param imgUrl 图片url
*/
private void shareImgToQQ(String imgUrl) {
params = new Bundle();
params.putInt(QQShare.SHARE_TO_QQ_KEY_TYPE, QQShare.SHARE_TO_QQ_TYPE_IMAGE);// 设置分享类型为纯图片分享
params.putString(QQShare.SHARE_TO_QQ_IMAGE_LOCAL_URL, imgUrl);// 需要分享的本地图片URL
// 分享操作要在主线程中完成
ThreadManager.getMainHandler().post(new Runnable() {
@Override
public void run() {
mTencent.shareToQQ(mActivity, params, mIUiListener);
}
});
}
注:默认为图片分享,需要进行音乐、应用、纯图片分享的,请参照SDK内的说明文档进行代码的编写,注:有些参数在文档上显示的比较坑(你懂得),一定要仔细辨认!一定要仔细辨认!一定要仔细辨认!
具体详情请参阅接口调用说明1.11 分享消息到 QQ(无需 QQ 登录)(2)分享纯图片
3.3 分享到QQ空间
- 默认分享-图文并存
private Bundle params;
private void shareToQZone() {
params = new Bundle();
params.putInt(QzoneShare.SHARE_TO_QZONE_KEY_TYPE,QzoneShare.SHARE_TO_QZONE_TYPE_IMAGE_TEXT);
params.putString(QzoneShare.SHARE_TO_QQ_TITLE, "标题");// 标题
params.putString(QzoneShare.SHARE_TO_QQ_SUMMARY, "要分享的摘要");// 摘要
params.putString(QzoneShare.SHARE_TO_QQ_TARGET_URL,"http://www.qq.com/news/1.html");// 内容地址
ArrayList<String> imgUrlList = new ArrayList<>();
imgUrlList.add("http://f.hiphotos.baidu.com/image/h%3D200/sign=6f05c5f929738bd4db21b531918a876c/6a600c338744ebf8affdde1bdef9d72a6059a702.jpg");
params.putStringArrayList(QzoneShare.SHARE_TO_QQ_IMAGE_URL,imgUrlList);// 图片地址
// 分享操作要在主线程中完成
ThreadManager.getMainHandler().post(new Runnable() {
@Override
public void run() {
// TODO Auto-generated method stub
mTencent.shareToQzone(mActivity, params,mIUiListener);
}
});
}
- 上传图片到QQ空间
/**
* 发表到QQ空间
*
* @param imgUrlList 图片地址集合--上传的只能是本地图片!
*/
private void publishToQzone(ArrayList<String> imgUrlList) {
// 分享类型
params = new Bundle();
params.putInt(QzonePublish.PUBLISH_TO_QZONE_KEY_TYPE, QzonePublish.PUBLISH_TO_QZONE_TYPE_PUBLISHMOOD);
params.putString(QzonePublish.PUBLISH_TO_QZONE_SUMMARY, "说说正文");
params.putStringArrayList(QzonePublish.PUBLISH_TO_QZONE_IMAGE_URL,
imgUrlList);// 图片地址ArrayList
// 分享操作要在主线程中完成
ThreadManager.getMainHandler().post(new Runnable() {
@Override
public void run() {
// TODO Auto-generated method stub
mTencent.publishToQzone(mActivity, params, mIUiListener);
}
});
}
注:除了默认的分享图文外,还支持发表说说、视频或上传照片这三种模式,同上,需要参阅SDK开发指南文档,同理,请注意规避文档上的坑。
上传图片到QQ空间时,图片只能是本地照片!
具体详情请参阅接口调用说明1.12 分享到 QQ 空间(无需 QQ 登录)(2)发表说说、视频或上传图片,看参数意义就行了,文档代码。。。就是坑。。
4.注意事项
- APP ID
一定要替换成自己申请的appid——运行前检查AndroidManifest.xml中与Activity中
Tencent.createInstance
内使用的appid是否正常。
注意在AndroidMaifest.xml中,需要填写tencent您的appid,appid前多了个tencent!
- 应用权限的添加
- Q空间和QQ SSO授权的Activity注册
友情提示
在参阅分享sdk内接口调用说明书时:
一!定!要!仔!细!看!参!数!说!明!
千!万!不!要!拷!贝!官!方!代!码!使!用!
最新更新时间 2017/08/01