更新记录

2.4（2023-08-28）

1、更新插件ios端抖音sdk版本到4.1.7。 2、修复挂载小程序时extras传递参数micro_app_task_id类型问题。

2.3（2023-02-08）

Android端更新SDK版本到0.1.9.6，iOS端修复新版HBuilderx打包失败问题。

2.2（2022-12-12）

修复2.1版本iOS端分享成功后不能回调的问题。

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

抖音授权分享插件接口说明

注意：使用插件前先到抖音开放平台申请clientKey，Android绑定包名和签名，ios绑定bundleId，打包时需要对应。

1. 插件对象

var sdkwx = uni.requireNativePlugin('DouYin-SdkWX');

2. 在onLoad初始化，只需调用一次

var clientkey = "xxxxdh3k1fioxxxx";// 需要到开发者网站申请并替换
sdkwx.initWithKey(clientkey);

//检查授权相册权限
sdkwx.checkAlbumPermission(function(res){
    console.log(res);
});

3. 检查抖音app是否安装

sdkwx.isAppInstalled(function(res){
    if (res == true) {
        //已安装抖音app
    } else {
        //未安装抖音app
    }
});

4. 授权登录

注：测试模式下授权需要设置白名单授权trial.whitelist，正式需要去掉

sdkwx.authorize({
    scope:"user_info",// 用户授权时必选权限
    state:""//用于保持请求和回调的状态，授权请求后原样带回给第三方，可传任意String
}, function(res){
    console.log(res);
    //res.errorCode  //OK = 0 授权成功， ERROR_UNKNOW = -1 未知错误， ERROR_CANCEL = -2 用户手动取消
    //res.errorMsg
    //res.authCode   //临时票据code，用来换取access_token
    //res.state      //第三方程序发送时用于表示其请求的唯一性标志，由第三方程序调openApi.authorize(request)时传入，由抖音终端回传。
    //res.grantedPermissions    //第三方通过用户授权取得的授权域
});

5. 分享图片或视频

注：不支持分享网络路径的图片和视频，需要先下载到本地，转换成原生平台的路径，ios无需再次保存相册

var path = plus.io.convertLocalFileSystemURL("uniapp路径");

sdkwx.share({
    imagePaths:[
        "图片平台的绝对路径/storage/emulated/0/Android/**/apps/__UNI__05D5D11/doc/**9577.jpg"
    ],
    videoPaths:[
        "视频平台的绝对路径"
    ],/*/imagePaths和videoPaths二选其一//*/
    state:""/*,//用于保持请求和回调的状态，授权请求后原样带回给第三方，可传任意String
    shareToPublish:true,//直接分享到抖音发布页,分享到发布页目前只支持单视频发布。
    microAppInfo:{
        appId:"ttef9b992670bxxxx",
        appTitle:"小程序title",
        appUrl:"pages/movie/index?utm_source=share_wxapp&cityId=10&cityName=%E4%B8%8A%E6%B5%B7",
        description:"小程序描述"
    }, //可选，分享内容携带小程序
    extras:{
        "micro_app_task_id":"7265506428227xxxxxx",
        "agent_client_key":"xxxxxxxxxxxxxxxx"
    },//挂载小程序时必需要配置
    hashtags:[
        "话题"
    ]//可选， 分享内容携带话题//*/
}, function(res){
    console.log(res);
    //res.errorCode     //参照官方文档说明
    //res.subErrorCode  //参考官方文档说明
    //res.errorMsg
    //res.state
});

6. 分享到抖音联系人

sdkwx.shareToContacts({
    imagePaths:[
        "图片平台的绝对路径/storage/emulated/0/Android/**/apps/__UNI__05D5D11/doc/**9577.jpg"
    ],
    htmlObject:{//链接
        html:"", // html链接（必填）
        title:"",//html  title（必填）
        discription:"", //html描述（必填）
        thumbUrl:"" //html的封面图(远程图片) （必填）    
    },/*/imagePaths(只能分享单图)、和htmlObject二选其一//*/
    state:""
},function(res){
    console.log(res);
    //res.errorCode     //参照官方文档说明
    //res.subErrorCode  //参考官方文档说明
    //res.errorMsg
    //res.state
}); 

7. 打开抖音拍摄器

sdkwx.openRecordPage({
    state:""/*,//用于保持请求和回调的状态，授权请求后原样带回给第三方，可传任意String
    microAppInfo:{
        appId:"ttef9b992670b151ec",
        appTitle:"小程序title",
        appUrl:"pages/movie/index?utm_source=share_wxapp&cityId=10&cityName=%E4%B8%8A%E6%B5%B7",
        description:"小程序描述"
    }, //可选，分享内容携带小程序
    extras:{
        "micro_app_task_id":"7265506428227xxxxxx",
        "agent_client_key":"xxxxxxxxxxxxxxxx"
    },//挂载小程序时必需要配置
    hashtags:[
        "话题"
    ]//可选， 分享内容携带话题//*/
},function(res){
    console.log(res);
    //res.errorCode     //参照官方文档说明
    //res.subErrorCode  //参考官方文档说明
    //res.errorMsg
    //res.state
});

8. 在manifest.json配置中，ios设置, UrlScheme设置 clientkey

/* ios打包配置 */
"ios" : {
    "urltypes" : "xxxxdh3k1fioxxxx"
}