功能介绍

分享到IM是指第三方App通过接入该功能，让用户可以从 App 分享单张照片或链接到抖音联系人。

分享的过程是通过相册对资源进行跨进程通信。所以首先要确保您的 App 已经提供相册的权限。

准备工作

开始进行分享之前，已经默认你，完成了接入指南中的申请、配置过程。如果还未完成，请参考 抖音授权分享 SDK 入门指南完成配置。

实现一次分享的步骤如下：

第一步:引入头文件

引入DouyinOpenSDKShare.h这个头文件

#import <DouyinOpenSDK/DouyinOpenSDKShare.h>

第二步:构造分享的请求

构造分享到抖音的分享请求

DouyinOpenSDKShareRequest *req = [[DouyinOpenSDKShareRequest alloc] init];

第三步:设置分享图片或者链接参数

分享图片

只前只支持传入一个图片。

设置分享的资源标示，传入资源在系统相册的local identifier 注意点：

• 若分享的为图片，则图片的宽高比应满足：1/2.2<=宽高比<=2.2。
• 若分享的为视频，视频分辨率应满足：1/2.2<=宽高像素比<=2.2，且总时长大于3s。
• 若分享的为图片个数应该超过1个，图片或视频个数最多12个。
• 带品牌logo或品牌水印的视频，会命中抖音的审核逻辑，有比较大的概率导致分享视频推荐降权处理/分享视频下架处理/分享账号被封禁处理。强烈建议第三方应用自行处理好分享内容中的不合规水印。
• 分享的话题审核依旧遵循抖音的审核逻辑，强烈建议第三方谨慎拟定话题名称，避免强导流行为。

req.localIdentifiers = media;//NSArray<NSString *> *

设置分享操作到抖音IM

req.shareAction = BDOpenPlatformShareTypeShareContentToIM;

分享链接

BDOpenPlatformShareLink *link = [BDOpenPlatformShareLink new];
link.linkURLString = @"https://open.douyin.com/platform";
link.linkTitle = @"抖音开放平台";
link.linkDescription = @"抖音开放平台，致力于打造抖音开放的生态系统，将从基础能力、内容、数据、服务等层面的开放，为开发者提供高效便捷的解决方案";
link.linkCoverURLString = @"https://sf3-cdn-tos.douyinstatic.com/obj/ttfe/open/imgs/logo-text.png";

req.shareLink = link;

设置分享操作到抖音IM

req.shareAction = BDOpenPlatformShareTypeShareContentToIM;

第四步:发送请求

在设置好分享需要带入的信息之后,通过-[DouyinOpenSDKShareRequest sendShareRequestWithCompleteBlock:]发送分享请求，结果将通过CompleteBlock进行回调

[req sendShareRequestWithCompleteBlock:^(BDOpenPlatformShareResponse * _Nonnull respond) {
        NSString *alertString = nil;
        if (respond.isSucceed) {
            //  Share Succeed
        } else{
            //  Share failed
        }
}];

分享结果说明: 如果分享失败可通过respond.errCode获取错误码对应枚举值BDOpenPlatformErrorCode 通过respond.errString会返回报错信息。

错误码对应表:

如果错误码不能方便你定位具体出错的问题，你可以通过 respond.shareState 进行错误定位。需要接入 SDK 2.0.8 以上版本

以下为 Share State 信息的对应关系：