更新记录

1.7.8(2024-10-15)

  • 修复安卓端"打开录制拍摄" 功能发布成功后,点击返回到原应用时无效果的问题.

1.7.7(2024-09-20)

  • 新增在【打开抖音录制视频】功能中,增加标题设置和插入话题和@用户的功能。

1.7.6(2024-05-07)

  • 新增加分享小程序 给好友功能。
查看更多

平台兼容性

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

原生插件通用使用流程:

  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 打包应用后才生效。

一. 插件使用介绍

提醒: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=>{

});

抖音授权登录,添加白名单用户权限测试

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

});
  • 参说介绍
名称 说明 必填
scope 授权域名称,默认为:user_info,如果是多个权限用逗号,隔开例如添加白名单权限:"user_info,trial.whitelist"
state 两种传值:1:传入自定义字符串,唯一标识这次请求。
2:传入 OpenAPI 中申请 ShareID,分享结果会通过 Webhooks 进行回调。
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 两种传值:1:传入自定义字符串,唯一标识这次请求。
2:传入 OpenAPI 中申请 ShareID,分享结果会通过 Webhooks 进行回调。
poiId 字符串, poi 锚点数据,出现在发布页
isImageAlbum 布尔值,是否开启图片集 true 或 false,默认 false
microAppInfo 分享小程序数据 json,成功发布视频后,在视频左下角带有小程序入口。
shareToPublish 布尔值 是否直接分享到抖音发布页。将图片直接分享到发布页需要使用新版分享
newShare 布尔值 是否使用新版分享
  • 视频分享
    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({
"title": "全集观看《回档1990》",  //标题
"hashtagTitleMarker":[{  //插入话题
    name:"回档1990",
    start:2  //插入在标题中从第几个开始插入
},{
    name:"全集观看",
    start:8
}],
"mentionTitleMarker":[  //@用户
{
    openId:"",   //@用户id
    start:8 
}
],
"micro_app_task_id":0,
"agent_client_key":"",
"poiId":"",
"microAppInfo": {
"title": "全集观看《回档1990》",
"description": "点击观看精彩后续",
"appid": "tt151d63a08a2372db01",
"url": "pages/theater/theater?id=789&episode=1&msgType=tpdaren&msgId=bjqysk@112372"
},
"state": "43401672"
}, 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 => {

        });
  • 分享小程序给好友

    microAppInfo 参数分享小程序给好友


plug.shareContentTM({
        microAppInfo:{
            appId:"",  // 小程序的appid,必传
            title:"", //小程序卡片的title,必传
            path:"",  //点击小程序落地页的path
            query:"", //点击小程序落地页的query
            imageId:"" //小程序卡片的封面图,通过OpenAPI获取,必传
        }
}, ret => {

        });

安卓 Android 扫一扫 下载体险

隐私、权限声明

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

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

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

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

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