douyin

来自于:开发者立即使用

/ Title: douyin Description: douyin /

论坛示例

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

概述

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及更高版本