更新记录

0.0.1(2025-08-19)

  • init

平台兼容性

云端兼容性

阿里云 腾讯云 支付宝云

uni-app(4.72)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
- - - - - - 5.0 12 -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 快应用-华为 快应用-联盟
- - - - - - - - - - -

uni-app x(4.73)

Chrome Safari Android iOS 鸿蒙 微信小程序
- - 5.0 12 - -

lime-xhsshare 小红书功能集成

lime-xhsshare UTS插件集成小红书核心功能(分享图片、分享视频等)的接口使用方法,适用于Android/iOS,未测试。

安装

插件市场导入,在页面引入,修改各平台的文件后,自定义基座
请在试用后,确定需要后才购买。

Android

uni_modules/lime-xhsshare/utssdk/app-android/AndroidManifest.xml文档中将所有填写真实包名换成你的应用包名

iOS

uni_modules/lime-xhsshare/utssdk/app-ios/Info.plist文档将填写小红书AppKey换成你的小红书AppKey

代码演示

初始化小红书配置

import {useXhsShare, type LimeXhsShareConfig} from '@/uni_modules/lime-xhsshare';

const xhsUtils = useXhsShare({
  appKey: "小红书开放平台AppKey", // 小红书开放平台AppKey
  universalLink: "https://yourdomain.com/universal-link/", // iOS Universal Link
  success: (res) => console.log("初始化成功", res),
  fail: (err) => console.error("初始化失败", err)
} as LimeXhsShareConfig);

LimeXhsShareConfig

参数名 类型 必填 说明 平台差异 默认值
appKey string 小红书开放平台注册的AppKey Android/iOS 均需
universalLink string iOS必填 iOS Universal Link(用于小红书分享等功能) 仅iOS生效
success (res: LimeXhsSuccessCallbackResult) => void 初始化成功的回调(返回状态码及消息)
fail (res: LimeXhsFail) => void 初始化失败的回调(包含错误码及错误信息)
complete (res: any) => void 接口调用完成的回调(无论成功/失败均触发)

小红书客户端检查

// 是否存在小红书客户端
xhsUtils.isInstalled() 

打开小红书活动页

xhsUtils.openUrl("https://www.xiaohongshu.com/activity-page")

分享图片

import { type LimeXhsShareOptions} from '@/uni_modules/lime-xhsshare';
xhsUtils.share({
  type: 'image',
  imageUrl: 'https://example.com/share-image.jpg',
  thumb: 'https://example.com/thumbnail.jpg', // 建议提供缩略图
  title: '分享标题',
  summary: '分享描述'
} as LimeXhsShareOptions);

分享视频

import { type LimeXhsShareOptions} from '@/uni_modules/lime-xhsshare';
// 分享示例
xhsUtils.share({
  type: 'video',
  title: '精彩视频',
  summary: '这是一段精彩的视频',
  videoUrl: 'https://example.com/movie-trailer.mp4',
  thumb: 'https://example.com/video-thumb.jpg' // 建议提供缩略图
} as LimeXhsShareOptions);

LimeXhsShareOptions 参数说明表

参数名 类型 必填条件 说明 适用分享类型 示例值
type string 必填 分享类型:image(图片) 或 video(视频) 所有类型 "image"
title string 分享标题 image/video "限时特惠"
summary string 分享描述 image/video "点击领取新人礼包"
thumb string 建议提供 缩略图URL(建议<32KB) image/video "https://example.com/thumb.jpg"
imageUrl string image类型必填 图片资源地址(支持本地路径) image "/static/share.jpg"
videoUrl string video类型必填 视频URL video "https://example.com/video.mp4"
success (res: LimeXhsSuccessCallbackResult) => void 分享成功的回调
fail (res: LimeXhsFail) => void 分享失败的回调(包含错误码及错误信息)
complete (res: any) => void 接口调用完成的回调(无论成功/失败均触发)

分享相关错误码表

错误码 说明 常见原因 处理建议
9010001 小红书未安装 用户设备未安装小红书App 提示用户安装小红书App
9010002 小红书版本号太低 用户设备小红书版本过低 提示用户升级小红书App
9010003 资源缺失 图片或视频资源未提供 检查imageUrl或videoUrl参数
9010004 图片或者视频文件不存在 提供的文件路径无效 检查文件路径是否正确
9010005 文件处理失败 文件格式不支持或损坏 检查文件格式是否正确
9010008 鉴权失败 AppKey无效或未正确配置 检查AppKey和universalLink配置
9010009 打开分享页面失败 小红书App响应异常 检查小红书App是否正常运行
9010010 传递数据有误 参数格式错误 检查分享参数格式
9010022 用户取消发布 用户主动取消分享操作 属于正常用户行为,可以引导用户重新分享

隐私、权限声明

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

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

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

暂无用户评论。