分享到 :

分享消息到QQ(无需QQ登录)

A、接口使用场景

    分享消息到QQ的接口,可将新闻、图片、文字、应用等分享给QQ好友、群和讨论组。Tencent类的shareToQQ函数可直接调用,不用用户授权(使用手机QQ当前的登录态)。调用将打开分享的界面,用户选择好友、群或讨论组之后,点击确定即可完成分享,并进入与该好友进行对话的窗口。

B、接口方法

    public void com.tencent.tauth.Tencent.shareToQQ(Activity activity, Bundle params, IUiListener listener)

C、接口参数

    调用邀请接口的参数说明如下:

参数参数说明
activity调用者所在Activity
paramsKV参数对,具体取值见下表
listener回调

本接口支持6种模式,每种模式的params参数设置不同,下面分别进行介绍:

(模式1) 分享图文消息

    接口参数
    调用分享接口分享图文消息的params参数说明如下:

示例代码
    调用分享接口分享图文消息的示例代码如下:

private void onClickShare() {
final Bundle params = new Bundle();
params.putInt(QQShare.SHARE_TO_QQ_KEY_TYPE, Tencent.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, "测试应用222222");
params.putInt(QQShare.SHARE_TO_QQ_EXT_INT, "其他附加功能");
mTencent.shareToQQ(MainActivity.this, params, new BaseUiListener());
}

(模式2) 分享纯图片

    接口参数
    调用分享接口分享纯图片的params参数说明如下:

示例代码
调用分享接口分享纯图片的示例代码如下:

private void onClickShare() {
    Bundle params = new Bundle();
    params.putString(QQShare.SHARE_TO_QQ_IMAGE_LOCAL_URL,imageUrl.getText().toString());
     params.putString(QQShare.SHARE_TO_QQ_APP_NAME, appName.getText().toString());
     params.putInt(QQShare.SHARE_TO_QQ_KEY_TYPE, QQShare. SHARE_TO_QQ_TYPE_IMAGE);
     params.putInt(QQShare.SHARE_TO_QQ_EXT_INT, QQShare. SHARE_TO_QQ_FLAG_QZONE_AUTO_OPEN);
mTencent.shareToQQ(MainActivity.this, params, new BaseUiListener());
}

增加纯图分享图片不能大于5M的限制:

String localPath = params.getString(SHARE_TO_QQ_IMAGE_LOCAL_URL);
File file = new File(localPath);
if (file.length() >= 5 * 1024 * 1024) {
    if (listener != null) {
        listener.onError(new UiError(Constants.ERROR_IMAGE_TOO_LARGE, Constants.MSG_SHARE_IMAGE_TOO_LARGE_ERROR, null));
    }
    SLog.e(TAG, "doShareImageToQQ -- error: " + Constants.MSG_SHARE_IMAGE_TOO_LARGE_ERROR);
    return;
}

(模式3) 分享音乐

    音乐分享后,发送方和接收方在聊天窗口中点击消息气泡即可开始播放音乐。
    接口参数
    调用分享接口分享音乐的params参数说明如下:

示例代码
    调用分享接口分享音乐的示例代码如下:

private void onClickAudioShare() {
     final Bundle params = new Bundle();
     params.putInt(QQShare.SHARE_TO_QQ_KEY_TYPE, Tencent.SHARE_TO_QQ_TYPE_AUDIO);
     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_AUDIO_URL, "音乐链接");
     params.putString(QQShare.SHARE_TO_QQ_APP_NAME, "测试应用222222");
params.putInt(QQShare.SHARE_TO_QQ_EXT_INT,QQShare.SHARE_TO_QQ_FLAG_QZONE_AUTO_OPEN);
mTencent.shareToQQ(MainActivity.this, params, new BaseUiListener());
}

(模式4) 分享应用

(已废弃)

    应用分享后,发送方和接收方在聊天窗口中点击消息气泡即可进入应用的详情页。
    接口参数
    调用分享接口分享应用的params参数说明如下:

    示例代码
    调用分享接口分享应用的示例代码如下:

private void onClickAppShare() {
     final Bundle params = new Bundle();
params.putInt(QQShare.SHARE_TO_QQ_KEY_TYPE, Tencent.SHARE_TO_QQ_TYPE_APP);
params.putString(QQShare.SHARE_TO_QQ_TITLE, "要分享的标题");
params.putString(QQShare.SHARE_TO_QQ_SUMMARY, "要分享的摘要");
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_AUDIO_URL, "音乐链接");
params.putString(QQShare.SHARE_TO_QQ_APP_NAME, "测试应用222222");
params.putInt(QQShare.SHARE_TO_QQ_EXT_INT, QQShare.SHARE_TO_QQ_FLAG_QZONE_AUTO_OPEN);
mTencent.shareToQQ(MainActivity.this, params, new BaseUiListener());
}

(模式5)分享携带ARK JSON串

    调用分享接口分享图文消息、纯图片、音乐时可以携带额外ARK(手Q轻应用)参数JSON串,分享将被展示成ARK消息。
    接口额外参数
    调用分享接口分享分享图文消息、纯图片、音乐为ARK展示,params参数在模式1、模式2、模式3、模式4接口参数基础上新增额外参赛说明如下:

参数是否必传类型参数说明
QQShare.SHARE_TO_QQ_ARK_INFO可选StringARK JSON格式的字符串

    ARK JSON串说明:

JSON key是否必传类型参数说明
app必填StringARK应用名称,com.tencent.map
view必填StringARK应用对应展示的视图
meta必填StringARK应用元数据,view视图对应需要的JSON字符串元数据

    Ark JSON串例子 :                  {"app":"com.dianping.dpscope","view":"RestaurantShare","meta":{"ShopData":{"shopId":"2511961"}}}
    示例代码
    调用分享接口分享应用的示例代码如下:

// Bundle携带图文信息后,再添加ARK信息。
String arkStr = arkInfoTxt.getText().toString();
params.putString(QQShare.SHARE_TO_QQ_ARK_INFO, arkStr);

注意:携带ARK信息的同时,需要携带原本的图文信息,ARK信息只是作为可选项,传递的JSON串为空或者不规范,分享的仍然为原本的图文信息。

(模式6)分享成QQ小程序

    可以从外部app分享到手Q为一个QQ小程序,并可以指定预览图、文案、小程序路径:
    接口参数
    调用分享接口分享QQ小程序的params参数说明如下:

    示例代码

   

可以从外部app分享到手Q为一个QQ小程序,并可以指定预览图、文案、小程序路径:

接口参数

调用分享接口分享QQ小程序的params参数说明如下:

参数 是否必传 类型 参数说明
QQShare.SHARE_TO_QQ_KEY_TYPE必填Int分享的类型。分享小程序填QQShare.SHARE_TO_QQ_MINI_PROGRAM
QQShare.SHARE_TO_QQ_TITLE必填String分享的标题, 最长30个字符。如果不填,默认使用小程序名称作为标题
QQShare.SHARE_TO_QQ_SUMMARY必填String分享的消息摘要,最长40个字符。若不填,默认使用小程序后台注册的描述作为摘要
QQShare.SHARE_TO_QQ_TARGET_URL必填String兼容低版本的网页链接
QQShare.SHARE_TO_QQ_IMAGE_URL必填String分享预览封面图的url,或者是本地图的路径
QQShare.SHARE_TO_QQ_MINI_PROGRAM_APPID必填String分享的小程序appid,小程序与当前应用必须为同一个主体
QQShare.SHARE_TO_QQ_MINI_PROGRAM_TYPE可选String3表示正式版,1表示体验版
QQShare.SHARE_TO_QQ_MINI_PROGRAM_PATH必填String分享的小程序页面路径,如不需要指定,请填主页路径

Bundle miniProgramBundle = new Bundle();
miniProgramBundle.putString(QQShare.SHARE_TO_QQ_TITLE, title.getText().toString());
miniProgramBundle.putString(QQShare.SHARE_TO_QQ_SUMMARY, summary.getText().toString());
miniProgramBundle.putString(QQShare.SHARE_TO_QQ_TARGET_URL, targetUrl.getText().toString());
miniProgramBundle.putString(QQShare.SHARE_TO_QQ_IMAGE_URL, imageUrl.getText().toString());
miniProgramBundle.putString(QQShare.SHARE_TO_QQ_MINI_PROGRAM_APPID, mETMiniProgramAppid.getText().toString());
miniProgramBundle.putString(QQShare.SHARE_TO_QQ_MINI_PROGRAM_PATH, mETMiniProgramPath.getText().toString());
miniProgramBundle.putString(QQShare.SHARE_TO_QQ_MINI_PROGRAM_TYPE, mETMiniProgramType.getText().toString());
miniProgramBundle.putInt(QQShare.SHARE_TO_QQ_KEY_TYPE, shareType);
mTencent.shareToQQ(QQShareActivity.this, miniProgramBundle, qqShareListener);

返回顶部