更新记录

0.0.1（2026-02-11）

• init

平台兼容性

uni-app(4.72)

syh-xhsshare 小红书功能集成

syh-xhsshare UTS插件集成小红书核心功能（分享单图、多图、视频等）的接口使用方法，适用于Android/iOS。

特性

• ✅ 支持单图分享
• ✅ 支持多图分享（图片路径数组）
• ✅ 支持Base64图片数据分享（二进制数据直传）
• ✅ 支持视频分享
• ✅ 同时支持 Android 和 iOS
• ✅ 完善的错误码和回调机制

安装

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

Android

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

iOS

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

代码演示

初始化小红书配置

import {useXhsShare, type SyhXhsShareConfig} from '@/uni_modules/syh-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 SyhXhsShareConfig);

SyhXhsShareConfig

小红书客户端检查

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

打开小红书活动页

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

分享单图

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

分享多图（路径数组）

import { type SyhXhsShareOptions} from '@/uni_modules/syh-xhsshare';
xhsUtils.share({
  type: 'image',
  imageUrls: [
    'https://example.com/image1.jpg',
    'https://example.com/image2.jpg',
    'https://example.com/image3.jpg'
  ],
  title: '多图分享标题',
  summary: '一次分享多张精美图片'
} as SyhXhsShareOptions);

分享多图（Base64 数据）

import { type SyhXhsShareOptions} from '@/uni_modules/syh-xhsshare';
// 适用于动态生成的图片（如画布截图、图片处理后的结果）
xhsUtils.share({
  type: 'image',
  imageData: [
    'iVBORw0KGgoAAAANSUhEUgAA...', // Base64编码的图片数据1
    'iVBORw0KGgoAAAANSUhEUgBB...', // Base64编码的图片数据2
  ],
  title: 'Base64多图分享',
  summary: '支持直接传入图片二进制数据'
} as SyhXhsShareOptions);

分享视频

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

SyhXhsShareOptions 参数说明表

图片参数优先级

当同时传入多个图片参数时，优先级为：

1. imageData（Base64 数据）— 最高优先级
2. imageUrls（多图路径数组）— 次优先级
3. imageUrl（单图路径）— 最低优先级

分享相关错误码表