douyin

auth

shareImg

shareVideo

论坛示例

为帮助用户更好更快的使用插件，论坛维护了一个示例，示例中包含示例代码、知识点讲解、注意事项等，供您参考。

概述

douyin 封装了抖音开放平台sdk的授权和分享。使用前需要去抖音开放平台（https://open.douyin.com）创建应用并申请client Key 和client Secret。

config配置参数

<feature name="douyin"> 
    <param name="clientKey" value="your clientKey"/> 
  </feature>

ios用户需要 相册权限！相册权限！相册权限！重要的事情说三遍，额外配置 Info.plist的几个值（LSApplicationQueriesSchemes，CFBundleURLTypes，TikTokAppID，DouyinAppID），抖音有分国际版和国内版，所以需要配置的比较多，只需要用后台得到的clientkey，替换以下的yourkey yourkey 四个地方即可，完整Info.plist如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
    <dict>
        <key>LSApplicationQueriesSchemes</key>
        <array>
            <string>douyinopensdk</string>
            <string>douyinsharesdk</string>
            <string>snssdk1128</string>
        </array>
        <key>CFBundleURLTypes</key>
        <array>
            <dict>
                <key>CFBundleTypeRole</key>
                <string>Editor</string>
                <key>CFBundleURLName</key>
                <string>tiktok</string>
                <key>CFBundleURLSchemes</key>
                <array>
                    <string>yourkey yourkey</string>
                </array>
            </dict>
            <dict>
                <key>CFBundleTypeRole</key>
                <string>Editor</string>
                <key>CFBundleURLName</key>
                <string>douyin</string>
                <key>CFBundleURLSchemes</key>
                <array>
                    <string>yourkey yourkey</string>
                </array>
            </dict>
        </array>
        <key>TikTokAppID</key>
        <string>yourkey yourkey</string>
        <key>DouyinAppID</key>
        <string>yourkey yourkey</string>
    </dict>
</plist>

auth

打开抖音授权页面

auth({params}，function(ret,err))

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：


    {	
        cmd:"authorizationSuccess",	//authorizationSuccess授权，authorizationFailed取消	
        errorCode:0,//OK = 0 授权成功， ERROR_UNKNOW = -1 未知错误， ERROR_CANCEL = -2 用户手动取消
        authCode:"xxxxxx"//临时票据code，用来换取access_token
    }

示例代码


    var douyin = api.require('douyin');
    douyin.auth(
        function(ret, err){
              alert(JSON.stringify(ret));  
        });

可用性

Android系统，iOS系统

可提供的1.0.0及更高版本

shareImg

分享图片 (传入图片要求:宽高都大于360;高宽比需满足区间 1/2.2-2.2;分享内容带水印可能会受到限制或被删除，请勿携带水印)

shareImg()

params

imgs

  • 类型：数组
  • 描述：要分享的图片的路径，支持widget://,fs://

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：


    {	
        cmd:"onShare",		
        errorCode:0,
        /*
        -0	正常
        -1	未知错误
        -2	用户手动取消
        -3	发送失败
        -4	第三方未获取分享权限或获取权限失败
        -5	文件解析错误
        */
    }

示例代码


    var douyin=api.require('douyin');

    var param = {imgs:["widget://image/douyin/0.png","widget://image/douyin/1.png","widget://image/douyin/2.png"]};

    douyin.shareImg(param, function(ret, err){
            	alert(JSON.stringify(ret));
            });

可用性

Android系统，IOS系统

可提供的1.0.0及更高版本

shareVideo

分享视频 (传入视频要求:1、时长要求在3s以上;2、格式要求mp4文件，且文件支持解析;3、画幅会根据机型白名单判断是否支持更高分辨率的，非白名单最短边不大于1100px，机型白名单以内是4096*2160;4、多图/多视频数量不能超过12)

shareVideo()

params

videos

  • 类型：数组
  • 描述：要分享的视频的路径，支持widget://,fs://

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：


    {	
        cmd:"onShare",		
        errorCode:0,
        /*
        -0	正常
        -1	未知错误
        -2	用户手动取消
        -3	发送失败
        -4	第三方未获取分享权限或获取权限失败
        -5	文件解析错误
        */
    }

示例代码


    var param = {videos:["widget://image/douyin/1.mp4","widget://image/douyin/3.mp4"]};

    douyin.shareVideo(param, function(ret, err){
        alert(JSON.stringify(ret));
    });

可用性

Android系统，IOS系统

可提供的1.0.0及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2025/09/15