更新记录

1.7.4(2023-11-02)

  • 增加 携带小程序 塞入小程序任务信息 micro_app_task_id 和 agent_client_key 参数设置。

1.7.3(2023-07-19)

  • 修复IOS 端 hashtags 话题参考为空时出现闪退的问题。

1.7.2(2023-05-18)

  • 优化IOS 端打开抖音录制视频的方法。
查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间:4.4 - 12.0 armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 适用版本区间:9 - 16

原生插件通用使用流程:

  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原生插件配置”->”云端插件“列表中删除该插件重新选择


Android 和 IOS 抖音 第三方授权登录分享插件

1. 首先到 抖音开发平台申请应用 https://open.douyin.com/

2. 填写包名获得应用的 clientKey .

3. 需要在配置文件 manifest.json 原生插件设置处 勾选云端插件,填写 clientKey 打包应用后才生效。

一. 插件使用介绍

  • 如需要测试安卓 可以使用以下包名和 应用 clientKey, 进行云打包测试。
应用 clientKey : awsxdh3k1fiojgnu
应用包名: com.bytedance.sdk.share.demo

提醒:IOS 端 必须要配置urlschemewhitelist 白名单,必须配置 urlschemes 才能接收到授权后的回调 ,否则手机上安装了抖音,也是识别不了,打包后,检查手机上是否已存在基座,如果存在先把手机上旧的基座删除掉,再重新安装最新打包好的基座。

2. IOS 需要在项目的配置文件源代码视图下 manifest.json 设置 ios 白名单 和 urlschemes .

        "ios":
        {
            "urltypes" : [
            {
            "urlidentifier" : "douyin",
            "urlschemes" : ["awsxdh3k1fiojgnu"]  //名称是你应用 的 clientKey
            }
            ],
            "urlschemewhitelist" : "douyinopensdk,douyinsharesdk,snssdk1128"
        }

1. 引入插件

const plug=uni.requireNativePlugin("Html5app-Tiktok");

2. 方法介绍

方法名称 说明
auth() 抖音授权登录
share() 抖音分享

 二、方法使用介绍

1. 抖音授权登录

plug.auth({scope:"user_info",state:"0022"},ret=>{

});
  • 参说介绍
名称 说明 必填
scope 授权域名称,默认为:user_info,如果是多个权限用逗号,隔开例如:"user_info,trial.whitelist"
state 随便填字符串,用于验证提交,和返回是不是一致的作用。
optionalScope0 用户授权时可选权限0(默认选择),仅安卓端
optionalScope1 用户授权时可选权限1(默认选择)
  • 授权成功返回值
{"scope":"user_info",
"state":"0022",
"code":0,
"authCode":"cNDfAKWJwKzGjD11vS1aenYPH8biWYFqVsNM"
}
  • 获取 authCode 后,可以通过抖音api 接口来获取用户信息

  • 其他返回

{"msg":"取消授权","code":-2}

2. 抖音分享包括:图片分享 和 视频分享 两种

  • 图片分享
    plug.share(
    {
    images:[],
    hashtags:["话题","电影","音乐"],
    state:"00123"
    },
    ret=>{                                   

    });
  • 参数介绍
名称 说明 必填
images 图片是一个数组,需要填写的是图片平台绝对路径
hashtags 话题是一个数组,在Android 中使用,可以填写多个话题,IOS中,只有第一个有效,IOS 中只支持一个话题.
state 字符串, 随便填写,用于验证提交和返回的值是否一致。
  • 视频分享
    plug.share(
        {
        videos:[],
        hashtags:["话题","电影","音乐"],
        state:"0022",
        microAppInfo:{
        appid:"ttef9b992670b151ec小程序appid", 
        title:"小程序title",
        description:"小程序描述",
        url:"pages/movie/index 小程序页面",
        micro_app_task_id:"", //小程序任务id
        agent_client_key:"" //撮合中介

        }
    },
    ret=>{

    });
  • 参数介绍
名称 说明 必填
videos 视频是一个数组,需要填写的是视频平台绝对路径
hashtags 话题是一个数组,在Android 中使用,可以填写多个话题,IOS中,只有第一个有效,IOS 中只支持一个话题.
state 字符串, 随便填写,用于验证提交和返回的值是否一致。
microAppInfo 它是一个小程序 JSON 参数, 支持第三方分享内容至抖音时,携带相关小程序信息,成功发布视频后,在视频左下角带有小程序入口。开发者需要先在字节跳动小程序平台上开发小程序后,在抖音开放平台提交该功能的申请,完成 app 和指定小程序的绑定。
  • 字节跳动小程序 microAppInfo 参数介绍
名称 说明 必填
appid 小程序appid
title 小程序title
description 小程序描述
url pages/movie/index 小程序页面
  • 成功返回值
{"msg":"分享成功","code":0}
  • 其他返回
{"msg":"用户取消","code":-2}

分享标题和贴纸

plug.share({
                    videos:[videoPath],
                    newShare:true,
                    title:"这个是最新功能的标题和贴纸图片",
                    hashtagTitleMarker:[
                        {
                         name:"标记语",
                         start:2    
                        },
                        {
                         name:"快七吧",
                         start:6    
                        }
                    ],
                    hashtagSticker:[{
                        name:"电影",
                        offsetX:0.4,
                        offsetY:0.4 
                    },
                    {
                        name:"音乐",
                        offsetX:0.2,
                        offsetY:0.5 
                    }],
                    customSticker:[
                    {
                    path:path, //贴纸图片路径,
                    maxWidth:300,
                    scale:0.5,//缩放
                    offsetX:0.6, //横纵向偏移,贴纸中心点在归一化屏幕中的位置
                    offsetY:0.5 //横纵向偏移,贴纸中心点在归一化屏幕中的位置
                    },
                    {
                    path:path, //贴纸图片路径,
                    maxWidth:300,
                    scale:0.5,//缩放
                    offsetX:0.4, //横纵向偏移,贴纸中心点在归一化屏幕中的位置
                    offsetY:0.8 //横纵向偏移,贴纸中心点在归一化屏幕中的位置
                    }],
                    hashtags:["话题11", "电影22", "音乐33"],
                    state: "002222"
                }, ret => {
                    console.log(ret);
                    _this.tip = JSON.stringify(ret);

                });

打开抖音录制视频 openRecord

//打开抖音录制视频

plug.openRecord({
hashtags: ["话题", "电影", "音乐"],  //添加话题
// microAppInfo:{  //添加分享小程序
// title:"小程序title",
// description:"小程序描述",
// appid:"ttef9b992670b151ec", 
// url:"pages/movie/index",
//micro_app_task_id:"", //小程序任务id
//agent_client_key:"" //撮合中介
// },
state: "22" // 填写你的shareid,如果无则不填写
}, ret => {

});

分享到好友

  • 分享网络链接给好友
    plug.shareContentTM({
    url:"https://ext.dcloud.net.cn/plugin?id=1378",  //链接
    title:"抖音 第三方授权登录 分享插件", //标题
    description:"抖音 第三方授权 登录 分享图片视频", //描述内容
    coverUrl:"https://img-cdn-tc.dcloud.net.cn/uploads/avatar/000/02/07/67_avatar_max.jpg" //网络缩略图片
    }, ret => {

    });
  • 分享图片给好友

    imageUrl ,目前只能分享一张图片给好,图片是绝对路径,IOS端imageUrl留空,只能打开相册选择一张图片。


plug.shareContentTM({
            imageUrl:"/storage/emulated/0/DCIM/Camera/IMG_20211019_181040.jpg"
        }, ret => {

        });

安卓 Android 扫一扫 下载体险

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件本身不采集任何数据。

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问