更新记录
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 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
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 扫一扫 下载体险