Android JShare API
最近更新:2021-12-15
展开全部

Android JShare API

SDK 初始化 API

API - init

初始化接口,建议在项目的 Application 的 OnCreate 中使用。

  • SDK 1.5.0 之前的版本支持

接口定义

public static void init(Context context)
          public static void init(Context context)

        
此代码块在浮窗中显示

参数说明

  • context 应用的 ApplicationContext

API - init

初始化接口,建议在项目的 Application 的 OnCreate 中使用,这个初始化 API 支持代码中设置第三方平台信息。

  • SDK 1.5.0 及以后版本支持

接口定义

public static void init(Context context, PlatformConfig platformConfig)
          public static void init(Context context, PlatformConfig platformConfig)

        
此代码块在浮窗中显示

参数说明

  • context 应用的 ApplicationContext
  • platformConfig 第三方平台信息配置,详情见第三方平台信息设置 API

第三方平台信息设置 API

JShare 提供 PlatformConfig 类,实例化后可选择设置相应的第三方平台信息。

API - setWechat

设置微信平台信息。

接口定义

public PlatformConfig setWechat(String appId, String appSecret)
          public PlatformConfig setWechat(String appId, String appSecret)

        
此代码块在浮窗中显示

参数说明

  • appId 微信平台 appId
  • appSecret 微信平台 appSecret

API - setQQ

设置 QQ 平台信息。

接口定义

public PlatformConfig setQQ(String appId, String appKey)
          public PlatformConfig setQQ(String appId, String appKey)

        
此代码块在浮窗中显示

参数说明

  • appId QQ 平台 appId
  • appKey QQ 平台 appKey

API - setSinaWeibo

设置新浪微博平台信息。

接口定义

public PlatformConfig setSinaWeibo(String appKey, String appSecret, String redirectUrl)
          public PlatformConfig setSinaWeibo(String appKey, String appSecret, String redirectUrl)

        
此代码块在浮窗中显示

参数说明

  • appKey 新浪微博平台 appKey
  • appSecret 新浪微博平台 appSecret
  • redirectUrl 新浪微博平台的回调 url

API - setFacebook

设置 Facebook 平台信息。

接口定义

public PlatformConfig setFacebook(String appId, String appName)
          public PlatformConfig setFacebook(String appId, String appName)

        
此代码块在浮窗中显示

参数说明

  • appId Facebook 平台 appId
  • appName Facebook 平台 appName

API - setTwitter

设置 Twitter 平台信息。

接口定义

public PlatformConfig setTwitter(String consumerKey, String consumerSecret)
          public PlatformConfig setTwitter(String consumerKey, String consumerSecret)

        
此代码块在浮窗中显示

参数说明

  • consumerKey Twitter 平台 consumerKey
  • consumerSecret Twitter 平台 consumerSecret

API - setJchatPro

设置 JChatpro 平台信息。

接口定义

public PlatformConfig setJchatPro(String auth)
          public PlatformConfig setJchatPro(String auth)

        
此代码块在浮窗中显示

参数说明

  • auth JchatPro 平台 auth

获取已经正确配置的平台 API

API - getPlatformList

获取 SDK 所有能用的平台名称,如要使用某个平台,必须正确配置相应的 jar 以及第三方平台信息。

接口定义

public static List<String> getPlatformList()
          public static List<String> getPlatformList()

        
此代码块在浮窗中显示

设置调试模式 API

API - setDebugMode

设置调试模式。
注:该接口需在 init 接口之前调用,避免出现部分日志没打印的情况。多进程情况下建议在自定义的 Application 中 onCreate 中调用。

接口定义

public static void setDebugMode(boolean enable)
          public static void setDebugMode(boolean enable)

        
此代码块在浮窗中显示

参数说明

  • enable 为 true 则会打印 debug 级别的日志,false 则只会打印 warning 级别以上的日志

判断某平台分享是否有效 API

API - isClientValid

判断该平台的分享是否有效。

接口定义

public static boolean isClientValid(String name)
          public static boolean isClientValid(String name)

        
此代码块在浮窗中显示

参数说明

  • name 平台名称,值可选 Wechat.Name、WechatMoments.Name、WechatFavorite.Name、SinaWeibo.Name、SinaWeiboMessage.Name、QQ.Name、QZone.Name、Facebook.Name、FbMessenger.Name、Twitter.Name、JChatPro.Name。

分享 API

API - share

分享接口

接口定义

public static void share(String name, ShareParams shareParams, PlatActionListener shareActionListener))
          public static void share(String name, ShareParams shareParams, PlatActionListener shareActionListener))

        
此代码块在浮窗中显示

参数说明

  • name 平台名称,值可选 Wechat.Name、WechatMoments.Name、WechatFavorite.Name、SinaWeibo.Name、SinaWeiboMessage.Name、QQ.Name、QZone.Name、Facebook.Name、FbMessenger.Name、Twitter.Name、JChatPro.Name。
  • shareParams 分享的配置参数,具体设置请参考各个平台的分享参数说明。
  • shareActionListener 回调接口,可为 null,为 null 时则没有回调

判断某平台是否支持授权 API

API - isSupportAuthorize

判断某平台是否支持授权

  • SDK 1.2.0 以上版本支持

接口定义

public static boolean isSupportAuthorize(String name)
          public static boolean isSupportAuthorize(String name)

        
此代码块在浮窗中显示

参数说明

  • name 平台名称,值可选 Wechat.Name、WechatMoments.Name、WechatFavorite.Name、SinaWeibo.Name、SinaWeiboMessage.Name、QQ.Name、QZone.Name、Facebook.Name、FbMessenger.Name、Twitter.Name。

授权 API

API - authorize

授权接口

  • SDK 1.2.0 以上版本支持

接口定义

public static void authorize(String name, AuthListener authListener)
          public static void authorize(String name, AuthListener authListener)

        
此代码块在浮窗中显示

参数说明

  • name 平台名称,值可选 Wechat.Name、SinaWeibo.Name、QQ.Name、Facebook.Name、Twitter.Name、JChatPro.Name。
  • authListener 回调接口,可为 null,为 null 时则没有回调。

代码示例

JShareInterface.authorize(platform, new AuthListener() { @Override public void onComplete(Platform platform, int action, BaseResponseInfo data) { Logger.dd(TAG, "onComplete:" + platform + ",action:" + action + ",data:" + data); String toastMsg = null; switch (action) { case Platform.ACTION_AUTHORIZING: if (data instanceof AccessTokenInfo) { //授权信息 String token = ((AccessTokenInfo) data).getToken();//token long expiration = ((AccessTokenInfo) data).getExpiresIn();//token有效时间,时间戳 String refresh_token = ((AccessTokenInfo) data).getRefeshToken();//refresh_token String openid = ((AccessTokenInfo) data).getOpenid();//openid //授权原始数据,开发者可自行处理 String originData = data.getOriginData(); toastMsg = "授权成功:" + data.toString(); Logger.dd(TAG, "openid:" + openid + ",token:" + token + ",expiration:" + expiration + ",refresh_token:" + refresh_token); Logger.dd(TAG, "originData:" + originData); } break; } } @Override public void onError(Platform platform, int action, int errorCode, Throwable error) { String toastMsg = null; switch (action) { case Platform.ACTION_AUTHORIZING: toastMsg = "授权失败"; break; } } @Override public void onCancel(Platform platform, int action) { Logger.dd(TAG, "onCancel:" + platform + ",action:" + action); String toastMsg = null; switch (action) { case Platform.ACTION_AUTHORIZING: toastMsg = "取消授权"; break; } } });
          JShareInterface.authorize(platform, new AuthListener() {
    @Override
    public void onComplete(Platform platform, int action, BaseResponseInfo data) {
        Logger.dd(TAG, "onComplete:" + platform + ",action:" + action + ",data:" + data);
        String toastMsg = null;
        switch (action) {
            case Platform.ACTION_AUTHORIZING:
                if (data instanceof AccessTokenInfo) {        //授权信息
                    String token = ((AccessTokenInfo) data).getToken();//token
                    long expiration = ((AccessTokenInfo) data).getExpiresIn();//token有效时间,时间戳
                    String refresh_token = ((AccessTokenInfo) data).getRefeshToken();//refresh_token
                    String openid = ((AccessTokenInfo) data).getOpenid();//openid
                    //授权原始数据,开发者可自行处理
                    String originData = data.getOriginData();
                    toastMsg = "授权成功:" + data.toString();
                    Logger.dd(TAG, "openid:" + openid + ",token:" + token + ",expiration:" + expiration + ",refresh_token:" + refresh_token);
                    Logger.dd(TAG, "originData:" + originData);
                }
                break;
        }
    }

    @Override
    public void onError(Platform platform, int action, int errorCode, Throwable error) {
        String toastMsg = null;
        switch (action) {
            case Platform.ACTION_AUTHORIZING:
                toastMsg = "授权失败";
                break;
        }
    }

    @Override
    public void onCancel(Platform platform, int action) {
        Logger.dd(TAG, "onCancel:" + platform + ",action:" + action);
        String toastMsg = null;
        switch (action) {
            case Platform.ACTION_AUTHORIZING:
                toastMsg = "取消授权";
                break;
        }
    }
});

        
此代码块在浮窗中显示

判断是否已经授权 API

API - isAuthorize

判断是否已经授权接口

  • SDK 1.2.0 以上版本支持

接口定义

public static boolean isAuthorize(String name)
          public static boolean isAuthorize(String name)

        
此代码块在浮窗中显示

参数说明

  • name 平台名称,值可选 Wechat.Name、WechatMoments.Name、WechatFavorite.Name、SinaWeibo.Name、SinaWeiboMessage.Name、QQ.Name、QZone.Name、Facebook.Name、FbMessenger.Name、Twitter.Name。

删除授权 API

API - removeAuthorize

删除授权接口

  • SDK 1.2.0 以上版本支持

接口定义

public static void removeAuthorize(String name, AuthListener actionListener)
          public static void removeAuthorize(String name, AuthListener actionListener)

        
此代码块在浮窗中显示

参数说明

  • name 平台名称,值可选 Wechat.Name、WechatMoments.Name、WechatFavorite.Name、SinaWeibo.Name、SinaWeiboMessage.Name、QQ.Name、QZone.Name、Facebook.Name、FbMessenger.Name、Twitter.Name。
  • authListener 回调接口,可为 null,为 null 时则没有回调

代码示例

JShareInterface.removeAuthorize(platform, new AuthListener() { @Override public void onComplete(Platform platform, int action, BaseResponseInfo data) { Logger.dd(TAG, "onComplete:" + platform + ",action:" + action + ",data:" + data); String toastMsg = null; switch (action) { case Platform.ACTION_REMOVE_AUTHORIZING: toastMsg = "删除授权成功"; break; } } @Override public void onError(Platform platform, int action, int errorCode, Throwable error) { Logger.dd(TAG, "onError:" + platform + ",action:" + action + ",error:" + error); String toastMsg = null; switch (action) { case Platform.ACTION_REMOVE_AUTHORIZING: toastMsg = "删除授权失败"; break; } } @Override public void onCancel(Platform platform, int i) { } });
          JShareInterface.removeAuthorize(platform, new AuthListener() {
    @Override
    public void onComplete(Platform platform, int action, BaseResponseInfo data) {
       Logger.dd(TAG, "onComplete:" + platform + ",action:" + action + ",data:" + data);
       String toastMsg = null;
       switch (action) {
           case Platform.ACTION_REMOVE_AUTHORIZING:
               toastMsg = "删除授权成功";
               break;
       }
    }

    @Override
    public void onError(Platform platform, int action, int errorCode, Throwable error) {
        Logger.dd(TAG, "onError:" + platform + ",action:" + action + ",error:" + error);
        String toastMsg = null;
        switch (action) {
            case Platform.ACTION_REMOVE_AUTHORIZING:
                toastMsg = "删除授权失败";
                break;
        }
    }

    @Override
    public void onCancel(Platform platform, int i) {

    }
});

        
此代码块在浮窗中显示

获取个人信息 API

API - getUserInfo

获取个人信息接口

  • SDK 1.2.0 以上版本支持

接口定义

public static void getUserInfo(String platName, AuthListener authListener)
          public static void getUserInfo(String platName, AuthListener authListener)

        
此代码块在浮窗中显示

参数说明

  • name 平台名称,值可选 Wechat.Name、WechatMoments.Name、WechatFavorite.Name、SinaWeibo.Name、SinaWeiboMessage.Name、QQ.Name、QZone.Name、Facebook.Name、FbMessenger.Name、Twitter.Name。
  • authListener 回调接口,可为 null,为 null 时则没有回调

代码示例

JShareInterface.getUserInfo(platform, new AuthListener() { @Override public void onComplete(Platform platform, int action, BaseResponseInfo data) { Logger.dd(TAG, "onComplete:" + platform + ",action:" + action + ",data:" + data); String toastMsg = null; switch (action) { case Platform.ACTION_USER_INFO: if (data instanceof UserInfo) { //第三方个人信息 String openid = ((UserInfo) data).getOpenid(); //openid String name = ((UserInfo) data).getName(); //昵称 String imageUrl = ((UserInfo) data).getImageUrl(); //头像url int gender = ((UserInfo) data).getGender();//性别, 1表示男性;2表示女性 //个人信息原始数据,开发者可自行处理 String originData = data.getOriginData(); toastMsg = "获取个人信息成功:" + data.toString(); Logger.dd(TAG, "openid:" + openid + ",name:" + name + ",gender:" + gender + ",imageUrl:" + imageUrl); Logger.dd(TAG, "originData:" + originData); } break; } } @Override public void onError(Platform platform, int action, int errorCode, Throwable error) { Logger.dd(TAG, "onError:" + platform + ",action:" + action + ",error:" + error); String toastMsg = null; switch (action) { case Platform.ACTION_USER_INFO: toastMsg = "获取个人信息失败"; break; } } @Override public void onCancel(Platform platform, int action) { Logger.dd(TAG, "onCancel:" + platform + ",action:" + action); String toastMsg = null; switch (action) { case Platform.ACTION_USER_INFO: toastMsg = "取消获取个人信息"; break; } } });
          JShareInterface.getUserInfo(platform, new AuthListener() {
    @Override
    public void onComplete(Platform platform, int action, BaseResponseInfo data) {
        Logger.dd(TAG, "onComplete:" + platform + ",action:" + action + ",data:" + data);
        String toastMsg = null;
        switch (action) {
            case Platform.ACTION_USER_INFO:
                if (data instanceof UserInfo) {      //第三方个人信息
                    String openid = ((UserInfo) data).getOpenid();  //openid
                    String name = ((UserInfo) data).getName();  //昵称
                    String imageUrl = ((UserInfo) data).getImageUrl();  //头像url
                    int gender = ((UserInfo) data).getGender();//性别, 1表示男性;2表示女性
                    //个人信息原始数据,开发者可自行处理
                    String originData = data.getOriginData();
                    toastMsg = "获取个人信息成功:" + data.toString();
                    Logger.dd(TAG, "openid:" + openid + ",name:" + name + ",gender:" + gender + ",imageUrl:" + imageUrl);
                    Logger.dd(TAG, "originData:" + originData);
                }
                break;
        }
    }

    @Override
    public void onError(Platform platform, int action, int errorCode, Throwable error) {
        Logger.dd(TAG, "onError:" + platform + ",action:" + action + ",error:" + error);
        String toastMsg = null;
        switch (action) {
            case Platform.ACTION_USER_INFO:
                toastMsg = "获取个人信息失败";
                break;
        }
    }

    @Override
    public void onCancel(Platform platform, int action) {
        Logger.dd(TAG, "onCancel:" + platform + ",action:" + action);
        String toastMsg = null;
        switch (action) {
            case Platform.ACTION_USER_INFO:
                toastMsg = "取消获取个人信息";
                break;
        }
    }
});

        
此代码块在浮窗中显示

各个平台的分享参数说明

微信(包括微信朋友圈、微信收藏)

1)分享文本

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_TEXT
Text String 分享标题 不超过 10KB
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_TEXT); shareParams.setText("Text");//必须
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_TEXT);
shareParams.setText("Text");//必须

        
此代码块在浮窗中显示

2)分享图片

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_IMAGE
ImagePath String 本地图片路径 长度不能超过 10KB,大小不能超过 10M,ImagePath 与 ImageData 必须二选一
ImageData Bitmap 图片 Bitmap 大小不能超过 1 0M,ImagePath 与 ImageData 必须二选一
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_IMAGE); shareParams.setImagePath(file.getAbsolutePath()); //shareParams.setImageData(bitmap);
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_IMAGE);
shareParams.setImagePath(file.getAbsolutePath());
//shareParams.setImageData(bitmap);

        
此代码块在浮窗中显示

3)分享音乐

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_MUSIC
Title String 音乐标题 长度不能超过 512
Text String 音乐描述 长度不能超过 1K
MusicUrl String 音乐资源 Url 点击播放按钮可直接播放 url,长度不能超过 10K
Url String 跳转 Url 点击跳转页面 url,长度不能超过 10K
ImagePath String 缩略图,本地图片路径 长度不能超过 10KB,大小不能超过 32K,与 ImageData 二选一
ImageData Bitmap 缩略图,图片 Bitmap 大小不能超过 32K,与 ImagePath 二选一
ShareParams shareParams = new ShareParams(); shareParams.setTitle(share_title); shareParams.setText(share_text); shareParams.setShareType(Platform.SHARE_MUSIC); shareParams.setUrl(url); shareParams.setMusicUrl(music_url); shareParams.setImagePath(file.getAbsolutePath());
          ShareParams shareParams = new ShareParams();
shareParams.setTitle(share_title);
shareParams.setText(share_text);
shareParams.setShareType(Platform.SHARE_MUSIC);
shareParams.setUrl(url);
shareParams.setMusicUrl(music_url);
shareParams.setImagePath(file.getAbsolutePath());

        
此代码块在浮窗中显示

4)分享视频

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_VIDEO
Title String 视频标题 长度不能超过 512
Text String 视频描述 长度不能超过 1K,朋友圈不显示该字段内容
Url String 视频 Url 长度不能超过 10K
ImagePath String 缩略图,本地图片路径 长度不能超过 10KB,大小不能超过 32K,与 ImageData 二选一
ImageData Bitmap 缩略图,图片 Bitmap 大小不能超过 32K,与 ImagePath 二选一
ShareParams shareParams = new ShareParams(); shareParams.setTitle(share_title); shareParams.setText(share_text); shareParams.setShareType(Platform.SHARE_VIDEO); shareParams.setUrl(share_videourl); shareParams.setImagePath(file.getAbsolutePath());
          ShareParams shareParams = new ShareParams();
shareParams.setTitle(share_title);
shareParams.setText(share_text);
shareParams.setShareType(Platform.SHARE_VIDEO);
shareParams.setUrl(share_videourl);
shareParams.setImagePath(file.getAbsolutePath());

        
此代码块在浮窗中显示

5)分享网页

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_WEBPAGE
Title String 网页标题 长度不能超过 512,注:Title 和 Text 字段微信和微信收藏必须要有其一
Text String 网页描述 长度不能超过 1K,朋友圈不显示该字段内容,注:Title 和 Text 字段微信和微信收藏必须要有其一
Url String 网页 Url 长度不能超过 10K
ImagePath String 缩略图,本地图片路径 长度不能超过 10KB,大小不能超过 32K,与 ImageData 二选一
ImageData Bitmap 缩略图,图片 Bitmap 大小不能超过 32K,与 ImagePath 二选一
ShareParams shareParams = new ShareParams(); shareParams.setTitle(share_title); shareParams.setText(share_text); shareParams.setShareType(Platform.SHARE_WEBPAGE); shareParams.setUrl(share_url);//必须 shareParams.setImagePath(file.getAbsolutePath());
          ShareParams shareParams = new ShareParams();
shareParams.setTitle(share_title);
shareParams.setText(share_text);
shareParams.setShareType(Platform.SHARE_WEBPAGE);
shareParams.setUrl(share_url);//必须
shareParams.setImagePath(file.getAbsolutePath());

        
此代码块在浮窗中显示

6)分享 Emoji 表情(朋友圈、微信收藏不支持)

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_EMOJI
ImagePath String 本地图片路径 长度不能超过 10KB,大小不能超过 10M,ImagePath 与 ImageData 必须二选一
ImageData Bitmap 图片 Bitmap 大小不能超过 10M,ImagePath 与 ImageData 必须二选一
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_EMOJI); shareParams.setImagePath(file.getAbsolutePath());
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_EMOJI);
shareParams.setImagePath(file.getAbsolutePath());

        
此代码块在浮窗中显示

7)分享文件(朋友圈、微信收藏不支持)

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_FILE
FilePath String 本地文件路径 长度不能超过 10KB,大小不能超过 10M
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_FILE); shareParams.setFilePath(file.getAbsolutePath());
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_FILE);
shareParams.setFilePath(file.getAbsolutePath());

        
此代码块在浮窗中显示

8)分享小程序(朋友圈、微信收藏不支持)

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_MINI_PROGRAM
Title String 网页标题/小程序标题 长度不能超过 512,注:Title 和 Text 字段微信必须要有其一(微信低于 6.5.6 版本,小程序分享变网页分享)
Text String 网页描述/小程序描述 长度不能超过 1K,注:Title 和 Text 字段微信必须要有其一(微信低于 6.5.6 版本,小程序分享变网页分享)
Url String 网页 Url 长度不能超过 10K,用于微信低版本兼容,当微信客户端低于 6.5.6 时,小程序分享变网页分享
ImagePath String 缩略图,本地图片路径 长度不能超过 10KB,大小不能超过 32K,与 ImageData 二选一,如果都没有填,默认使用 MiniProgramImage 的数据,用于微信低版本兼容,当微信客户端低于 6.5.6 时,小程序分享变网页分享
ImageData Bitmap 缩略图,图片 Bitmap 大小不能超过 32K,与 ImagePath 二选一,如果都没有填,默认使用 MiniProgramImage 的数据,用于微信低版本兼容,当微信客户端低于 6.5.6 时,小程序分享变网页分享
MiniProgramPath String 小程序页面路径 发起分享的 App 与小程序属于同一微信开放平台帐号
MiniProgramUserName String 小程序原始 id 发起分享的 App 与小程序属于同一微信开放平台帐号
MiniProgramImagePath String 小程序缩略图,本地图片路径 长度不能超过 10KB,大小不能超过 128K,与 MiniProgramImageData 二必选一
MiniProgramImageData Bitmap 小程序缩略图,图片 Bitmap 大小不能超过 128K,与 MiniProgramImagePath 二必选一
MiniProgramWithShareTicket boolean 是否使用带 shareTicket 的分享 通常开发者希望分享出去的小程序被二次打开时可以获取到更多信息,例如群的标识。可以设置 withShareTicket 为 true,当分享卡片在群聊中被其他用户打开时,可以获取到 shareTicket,用于获取更多分享信息。最低客户端版本要求:6.5.13
MiniprogramType int 小程序的类型 正式版:0,开发版(测试版):1,体验版(预览版):2
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_MINI_PROGRAM); shareParams.setTitle(share_title); shareParams.setText(share_text); shareParams.setUrl(share_url);//用于微信低版本兼容,当微信客户端为低版本时,小程序分享变网页分享 shareParams.setImagePath(file.getAbsolutePath()); shareParams.setMiniProgramWithShareTicket(false);// shareParams.setMiniProgramType(0);// 正式版:0,开发版(测试版):1,体验版(预览版):2 shareParams.setMiniProgramImagePath(file.getAbsolutePath());//小程序图片地址 shareParams.setMiniProgramPath("pages/index/index");//小程序页面路径 shareParams.setMiniProgramUserName("gh_cd370c00d3d4");//小程序原始id
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_MINI_PROGRAM);
shareParams.setTitle(share_title);
shareParams.setText(share_text);
shareParams.setUrl(share_url);//用于微信低版本兼容,当微信客户端为低版本时,小程序分享变网页分享
shareParams.setImagePath(file.getAbsolutePath());
shareParams.setMiniProgramWithShareTicket(false);//
shareParams.setMiniProgramType(0);// 正式版:0,开发版(测试版):1,体验版(预览版):2
shareParams.setMiniProgramImagePath(file.getAbsolutePath());//小程序图片地址
shareParams.setMiniProgramPath("pages/index/index");//小程序页面路径
shareParams.setMiniProgramUserName("gh_cd370c00d3d4");//小程序原始id

        
此代码块在浮窗中显示

QQ

1)分享图片

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_IMAGE
ImagePath String 本地图片路径 ImagePath 与 ImageUrl 必须二选一
ImageUrl String 网络图片地址 由于 QQ 的原因,从 1.5.0 版本起不再支持
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_IMAGE); shareParams.setImagePath(file.getAbsolutePath());
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_IMAGE);
shareParams.setImagePath(file.getAbsolutePath());

        
此代码块在浮窗中显示

2)分享链接

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_WEBPAGE
Title String 标题 不超过 30 字符
Text String 描述 不超过 40 字符
ImagePath String 缩略图,本地图片路径 与 ImageUrl 二选一
ImageUrl String 缩略图,网络图片地址 必须以 http 或 https 开头,与 ImagePath 二选一
Url String 跳转链接 必须以 http 或 https 开头
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_WEBPAGE); shareParams.setTitle(share_title); shareParams.setText(share_text); shareParams.setUrl(share_url); shareParams.setImagePath(file.getAbsolutePath());
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_WEBPAGE);
shareParams.setTitle(share_title);
shareParams.setText(share_text);
shareParams.setUrl(share_url);
shareParams.setImagePath(file.getAbsolutePath());

        
此代码块在浮窗中显示

3)分享 app

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_APPS
Title String 标题 不超过 30 字符
Text String 描述 不超过 40 字符
ImagePath String 缩略图,本地图片路径 与 ImageUrl 二选一
ImageUrl String 缩略图,网络图片地址 必须以 http 或 https 开头,与 ImagePath 二选一
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_APPS); shareParams.setTitle(share_title); shareParams.setText(share_text); shareParams.setImagePath(file.getAbsolutePath());
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_APPS);
shareParams.setTitle(share_title);
shareParams.setText(share_text);
shareParams.setImagePath(file.getAbsolutePath());

        
此代码块在浮窗中显示

4)分享音乐

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_MUSIC
Title String 标题 不超过 30 字符
Text String 描述 不超过 40 字符
MusicUrl String 音乐链接 音乐文件的远程链接 ,点击播放按钮可直接播放, 以 URL 的形式传入 , 不支持本地音乐,必须以 http 或 https 开头
Url String 跳转链接 跳转页面 url,必须以 http 或 https 开头
ImagePath String 缩略图,本地图片路径 与 ImageUrl 二选一
ImageUrl String 缩略图,网络图片地址 必须以 http 或 https 开头,与 ImagePath 二选一
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_MUSIC); shareParams.setTitle(share_title); shareParams.setText(share_text); shareParams.setUrl(share_url); shareParams.setMusicUrl(music_url); shareParams.setImagePath(file.getAbsolutePath()); //shareParams.setImageUrl("http://inews.gtimg.com/newsapp_bt/0/876781763/1000");
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_MUSIC);
shareParams.setTitle(share_title);
shareParams.setText(share_text);
shareParams.setUrl(share_url);
shareParams.setMusicUrl(music_url);
shareParams.setImagePath(file.getAbsolutePath());
//shareParams.setImageUrl("http://inews.gtimg.com/newsapp_bt/0/876781763/1000");

        
此代码块在浮窗中显示

QQ 空间

1)分享文本

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_TEXT
Text String 描述 不超过 10000 字符
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_TEXT); shareParams.setText(share_text);
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_TEXT);
shareParams.setText(share_text);

        
此代码块在浮窗中显示

2)分享图片

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_IMAGE
ImagePath String 本地图片路径 ImagePath 与 ImageUrl、ImageArray 必须三选一
ImageUrl String 网络图片地址 必须以 http 或 https 开头,ImagePath 与 ImageUrl、ImageArray 必须三选一
ImageArray Array 图片地址数组 支持多个图片,超出 9 张后,会变成上传相册,上传相册时只支持本地图片,ImagePath 与 ImageUrl、ImageArray 必须三选一
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_IMAGE); shareParams.setImagePath(MyApplication.ImagePath); //shareParams.setImageUrl(share_imageurl); //String[] array = new String[]{ share_imageurl, share_imageurl_1}; //shareParams.setImageArray(array);
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_IMAGE);
shareParams.setImagePath(MyApplication.ImagePath);
//shareParams.setImageUrl(share_imageurl);
//String[] array = new String[]{ share_imageurl, share_imageurl_1};
//shareParams.setImageArray(array);

        
此代码块在浮窗中显示

3)分享链接

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_WEBPAGE
Title String 标题 最长 200 个字符
Text String 描述 最长 600 个字符
Url String 跳转链接 必须以 http 或 https 开头
ImagePath String 缩略图,本地图片路径 与 ImageUrl 二选一
ImageUrl String 缩略图,网络图片地址 必须以 http 或 https 开头,与 ImagePath 二选一
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_WEBPAGE); shareParams.setTitle(share_title); shareParams.setUrl(share_url); shareParams.setImagePath(file.getAbsolutePath()); //shareParams.setImageUrl("http://inews.gtimg.com/newsapp_bt/0/876781763/1000");
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_WEBPAGE);
shareParams.setTitle(share_title);
shareParams.setUrl(share_url);
shareParams.setImagePath(file.getAbsolutePath());
//shareParams.setImageUrl("http://inews.gtimg.com/newsapp_bt/0/876781763/1000");

        
此代码块在浮窗中显示

4)分享音乐

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_MUSIC
Title String 标题 最长 200 个字符
Text String 描述 最长 600 个字符
MusicUrl String 音乐链接 音乐文件的远程链接 ,点击播放按钮可直接播放, 以 URL 的形式传入 , 不支持本地音乐,必须以 http 或 https 开头
Url String 跳转链接 跳转页面 url,必须以 http 或 https 开头
ImagePath String 缩略图,本地图片路径 与 ImageUrl 二选一
ImageUrl String 缩略图,网络图片地址 必须以 http 或 https 开头,与 ImagePath 二选一
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_MUSIC); shareParams.setTitle(share_title); shareParams.setMusicUrl(share_musicurl); shareParams.setUrl(music_shareUrl); shareParams.setImagePath(file.getAbsolutePath()); //shareParams.setImageUrl("http://inews.gtimg.com/newsapp_bt/0/876781763/1000");
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_MUSIC);
shareParams.setTitle(share_title);
shareParams.setMusicUrl(share_musicurl);
shareParams.setUrl(music_shareUrl);
shareParams.setImagePath(file.getAbsolutePath());
//shareParams.setImageUrl("http://inews.gtimg.com/newsapp_bt/0/876781763/1000");

        
此代码块在浮窗中显示

5)分享本地视频

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_VIDEO
VideoPath String 本地视频地址 不支持网络视频
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_VIDEO); shareParams.setVideoPath(MyApplication.VideoPath);
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_VIDEO);
shareParams.setVideoPath(MyApplication.VideoPath);

        
此代码块在浮窗中显示

新浪微博

1)分享文本

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_TEXT
Text String 文本 不超过 1999 字符
ImagePath String 本地图片地址 不支持网络图片,文件不超过 10M,与 ImageData 二选一
ImageData Bitmap 本地图片 bitmap 不支持网络图片,不超过 2M,与 ImagePath 二选一
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_IMAGE); shareParams.setText(share_text); shareParams.setImagePath(file.getAbsolutePath());
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_IMAGE);
shareParams.setText(share_text);
shareParams.setImagePath(file.getAbsolutePath());

        
此代码块在浮窗中显示

2)分享图片

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_IMAGE
Text String 文本 不超过 1999 字符
ImagePath String 本地图片地址 不支持网络图片,文件不超过 10M,与 ImageData 二选一
ImageData Bitmap 本地图片 bitmap 不支持网络图片,不超过 2M,与 ImagePath 二选一
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_IMAGE); shareParams.setText(share_text); shareParams.setImagePath(file.getAbsolutePath());
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_IMAGE);
shareParams.setText(share_text);
shareParams.setImagePath(file.getAbsolutePath());

        
此代码块在浮窗中显示

3)分享链接

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_WEBPAGE
Text String 文本 不超过 1999 字符
ImagePath String 本地图片地址 不支持网络图片,文件不超过 10M,与 ImageData 二选一
ImageData Bitmap 本地图片 bitmap 不支持网络图片,不超过 2M,与 ImagePath 二选一
Url String 跳转链接 长度不超过 512 字节
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_WEBPAGE); shareParams.setText(share_text); shareParams.setImagePath(file.getAbsolutePath()); shareParams.setUrl(share_url);
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_WEBPAGE);
shareParams.setText(share_text);
shareParams.setImagePath(file.getAbsolutePath());
shareParams.setUrl(share_url);

        
此代码块在浮窗中显示

新浪微博私信

1)分享链接

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_WEBPAGE
Text String 文本 不超过 1024 字符
Title String 标题 不超过 512 字符
ImagePath String 本地图片地址 不支持网络图片,文件不超过 32K,与 ImageData 二选一
ImageData Bitmap 本地图片 bitmap 不支持网络图片,不超过 32K,与 ImagePath 二选一
Url String 跳转链接 长度不超过 512 字节
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_WEBPAGE); shareParams.setText(share_text); shareParams.setImagePath(file.getAbsolutePath()); shareParams.setUrl(share_url);
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_WEBPAGE);
shareParams.setText(share_text);
shareParams.setImagePath(file.getAbsolutePath());
shareParams.setUrl(share_url);

        
此代码块在浮窗中显示

Facebook、FbMessenger

1)分享链接

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_WEBPAGE
Url String 分享链接
Quote String 分享引用
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_WEBPAGE); shareParams.setUrl(share_url); shareParams.setQuote(quote);
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_WEBPAGE);
shareParams.setUrl(share_url);
shareParams.setQuote(quote);

        
此代码块在浮窗中显示

2)分享图片

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_IMAGE
ImagePath String 本地图片地址
ImageData String 本地图片 bitmap
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_IMAGE); shareParams.setImagePath(file.getAbsolutePath());
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_IMAGE);
shareParams.setImagePath(file.getAbsolutePath());

        
此代码块在浮窗中显示

2)分享视频

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_VIDEO
VideoPath String 本地视频地址
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_VIDEO); shareParams.setVideoPath(file.getAbsolutePath());
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_VIDEO);
shareParams.setVideoPath(file.getAbsolutePath());

        
此代码块在浮窗中显示

Twitter

1)分享文本

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_TEXT
Text String 文本 不可为空,文本长度不超过 140 字符
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_TEXT); shareParams.setText(text);
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_TEXT);
shareParams.setText(text);

        
此代码块在浮窗中显示

2)分享链接

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_WEBPAGE
Url String 分享链接 仅支持 http、https
Text String 文本 文本长度与链接长度之和不能超过 140 字符
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_WEBPAGE); shareParams.setUrl(share_url);
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_WEBPAGE);
shareParams.setUrl(share_url);

        
此代码块在浮窗中显示

3)分享图片

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_IMAGE
Text String 文本 与 url 总长度不能超过 140 字符
Url String 分享链接 仅支持 http、https,与文本总长度不超过 140 字符
ImagePath String 本地图片地址 JPG, PNG, GIF, WEBP 格式,不能超过 5M,ImagePath 与 ImageUrl、ImageArray 必须三选一
ImageData String 本地图片 bitmap JPG, PNG, GIF, WEBP 格式,不能超过 5M,ImagePath 与 ImageUrl、ImageArray 必须三选一
ImageArray Array 本地图片地址数组 支持多个图片,最多 4 张,JPG, PNG, GIF, WEBP 格式,单张不能超过 5M,ImagePath 与 ImageUrl、ImageArray 必须三选一
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_IMAGE); shareParams.setImagePath(file.getAbsolutePath());
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_IMAGE);
shareParams.setImagePath(file.getAbsolutePath());

        
此代码块在浮窗中显示

4)分享视频

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_VIDEO
Text String 文本 与 url 总长度不能超过 140 字符
Url String 分享链接 仅支持 http、https,与文本总长度不超过 140 字符
VideoPath String 本地视频地址 不支持网络视频,视频的格式要求较多,具体参考 twitter 文档:https://developer.twitter.com/en/docs/media/upload-media/uploading-media/media-best-practices
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_VIDEO); shareParams.setVideoPath(videoPath);
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_VIDEO);
shareParams.setVideoPath(videoPath);

        
此代码块在浮窗中显示

JChatPro

1)分享图文

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_IMAGETEXT
AppName String 应用名称
title String 消息标题
text String 消息内容
ImageUrl String 缩略图网络图片地址
TargetPkg String 点击消息时跳转应用的包名
TargetClass String 点击消息时跳转应用的类名
Extra String 点击消息跳转到第三方应用时带的 extra 信息
Url String 点击消息时跳转应用的 url
CallBackUrl String 点击消息跳转第三方应用失败时,回调的 url
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_IMAGETEXT); shareParams.setAppName("JShareDemo"); shareParams.setTitle(share_title); shareParams.setText(share_text); shareParams.setUrl(share_url); shareParams.setTargetPkg("com.tencent.mm"); shareParams.setTargetClass("com.tencent.mm.ui.LauncherUI"); shareParams.setExtra("this message from jshare.");
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_IMAGETEXT);
shareParams.setAppName("JShareDemo");
shareParams.setTitle(share_title);
shareParams.setText(share_text);
shareParams.setUrl(share_url);
shareParams.setTargetPkg("com.tencent.mm");
shareParams.setTargetClass("com.tencent.mm.ui.LauncherUI");
shareParams.setExtra("this message from jshare.");

        
此代码块在浮窗中显示

2)分享文本

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_TEXT
AppName String 应用名称
text String 消息内容,建议不超过 3Kb
TargetPkg String 点击消息时跳转应用的包名
TargetClass String 点击消息时跳转应用的类名
Extra String 点击消息跳转到第三方应用时带的 extra 信息
Url String 点击消息时跳转应用的 url(iOS 用)
CallBackUrl String 点击消息跳转第三方应用失败时,回调的 url
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_TEXT); shareParams.setAppName("JShareDemo"); shareParams.setText(share_text); shareParams.setUrl(share_url); shareParams.setTargetPkg("com.tencent.mm"); shareParams.setTargetClass("com.tencent.mm.ui.LauncherUI"); shareParams.setExtra("this message from jshare.");
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_TEXT);
shareParams.setAppName("JShareDemo");
shareParams.setText(share_text);
shareParams.setUrl(share_url);
shareParams.setTargetPkg("com.tencent.mm");
shareParams.setTargetClass("com.tencent.mm.ui.LauncherUI");
shareParams.setExtra("this message from jshare.");

        
此代码块在浮窗中显示

3)分享图片

参数 是否必须 参数类型 参数说明 备注
ShareType int 分享类型 Platform.SHARE_IMAGE
AppName String 应用名称
ImageUrl String 图片网络地址,与 img_path、img_array 三选一
ImagePath String 图片本地地址,与 img_url、img_array 三选一
ImageArray String 图片地址数组,与 img_url、img_path 三选一,最多 9 张
TargetPkg String 点击消息时跳转应用的包名
TargetClass String 点击消息时跳转应用的类名
Extra String 点击消息跳转到第三方应用时带的 extra 信息
Url String 点击消息时跳转应用的 url(iOS 用)
CallBackUrl String 点击消息跳转第三方应用失败时,回调的 url
ShareParams shareParams = new ShareParams(); shareParams.setShareType(Platform.SHARE_IMAGE); shareParams.setAppName("JShareDemo"); //shareParams.setImageUrl(image_url); //shareParams.setImagePath(image_path); //shareParams.setImageArray(image_array); shareParams.setUrl(share_url); shareParams.setTargetPkg("com.tencent.mm"); shareParams.setTargetClass("com.tencent.mm.ui.LauncherUI"); shareParams.setExtra("this message from jshare.");
          ShareParams shareParams = new ShareParams();
shareParams.setShareType(Platform.SHARE_IMAGE);
shareParams.setAppName("JShareDemo");
//shareParams.setImageUrl(image_url);
//shareParams.setImagePath(image_path);
//shareParams.setImageArray(image_array);
shareParams.setUrl(share_url);
shareParams.setTargetPkg("com.tencent.mm");
shareParams.setTargetClass("com.tencent.mm.ui.LauncherUI");
shareParams.setExtra("this message from jshare.");

        
此代码块在浮窗中显示
文档内容是否对您有帮助?

Copyright 2011-2022, jiguang.cn, All Rights Reserved. 粤ICP备12056275号-13 深圳市和讯华谷信息技术有限公司

在文档中心打开