CameraSDK 接入指南

<script src="https://static.xhey.top/sdk/prod/xhey-camera-sdk.v1.0.2.min.js"></script>

// eslint-disable-next-line no-undef
let camera = new XHeyCamera({
  // 【可选】是否需要关闭拍照确认页
  disablePhotoConfirm: false,
 
  // 【可选】开启自定义水印编辑，用户可以自己选择水印和编辑水印条目
  // 开启后，下面的watermarkId、title、logoUrl、customInputItems设置不生效
  enableCustomWatermark: false,
 
  // 【可选】手机型号，比如SM-S918U1
  // 如果可以获取到，最好传入，可以解决一些手机兼容性问题
  deviceModel: "your device model",
 
  // 【可选】手机品牌比如samsung
  // 如果可以获取到，最好传入，可以解决一些手机兼容性问题
  deviceBrand: "your device brand",
 
  // 【必须】应用 ID (替换为你的应用 ID)
  appid: "your appid",
 
  // 【必须】时间戳（单位：秒）
  timestamp: 1736928042,
 
  // 【必须】随机字符串
  noncestr: "65cdfefecaf3a0c4",
 
  // 【必须】签名（生成的签名）,最好在服务端做，防止密钥泄漏
  signature: "your generated signature",
 
  // 【可选】水印 ID
  watermarkId: watermarkId,
 
  // 【可选】自定义水印标题
  title: "自定义会议标题",
 
  // 【可选】自定义水印中的 Logo 图片 URL
  logoUrl: "",
 
  // 【可选】自定义水印中的项内容
  customInputItems: {
    "会议名称": "这是自定义的会议名称",
    "会议类型": "这是自定义的会议类型",
  },
 
  // 【可选】最大拍摄照片张数
  maxImageCount: 1,
 
  // 【可选】输出log回调
  enableLogMessage: true,
 
  // 【可选】关闭右下角官方水印
  disableOffcialWatermark: false,
 
  // 【可选】禁止水印拖动
  disableWatermarkDragging: false,
});

// maxImageCount为1时回调，拍照成功回调
camera.onSuccess((imageBase64Data, userCommentObject) => {
  // imageBase64Data 是图片的 Base64 数据
  // userCommentObject 有水印信息
  this.imageUrl = imageBase64Data;
  console.log("拍照成功");
});
 
// 取消操作回调
camera.onCancel(() => {
  console.log("取消操作");
});
 
// 错误回调
camera.onError((error) => {
  console.error("发生错误:", error);
});
 
// maxImageCount大于1时回调
camera.onCaptureStillImages((imageBase64DataArray) => {
  console.log("拍照成功:", imageBase64DataArray);
  this.splitLogos = imageBase64DataArray.map((imageBase64Data) => [
    { url: imageBase64Data },
  ]);
});
 
// logInfo回调
camera.onLogInfo((message) => {
  console.log(message);
});
 
// logError回调
camera.onLogError((message) => {
  console.error(message);
});
 
// logWarn回调
camera.onLogWarn((message) => {
  console.warn(message);
});

dependencies:
  flutter:
    sdk: flutter
  plugin_platform_interface: ^2.0.2
 
  xheycamerasdk:
    # SDK 路径
    path: ../xheycamerasdk

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-feature android:name="android.hardware.camera" android:required="true" />

<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>我们需要精确的位置信息来提供准确的服务</string>
<key>NSLocationAccuracy</key>
<string>我们需要精确的位置信息来提供准确的服务</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>我们需要在后台获取您的位置来提供服务</string>
<key>NSCameraUsageDescription</key>
<string>我们需要使用您的相机来拍摄照片</string>

target 'Runner' do
  # use_frameworks!
 
  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
  target 'RunnerTests' do
    inherit! :search_paths
  end
end
 
post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
 
    target.build_configurations.each do |config|
      config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
        '$(inherited)',
      ]
      config.build_settings['ENABLE_BITCODE'] = 'NO'
      config.build_settings['SWIFT_VERSION'] = '4.2'
    end
  end
end

void takePhoto(BuildContext context) {
  _xheyCameraSdk = XheyCameraSdk(
    appid: "your app id",
    secretKey: "your secret key",
    // 【可选】不传的话，用户可以自己选水印，传入的话就用配置的团队水印
    groupWatermarkId: "",
    delegate: MyXheyCameraSdkDelegate(state: this),
  );
  _xheyCameraSdk?.takePhoto();
}

class MyXheyCameraSdkDelegate implements XheyCameraSdkDelegate {
  final _MyAppState state;
 
  MyXheyCameraSdkDelegate({required this.state});
 
  @override
  void onCancel() {
    print("[MyApp]onCancel");
  }
 
  @override
  void onSuccess(List<Image> images) {
    if (images.isEmpty) {
      print("[MyApp]onSuccess: No images");
      return;
    }
 
    state.setState(() {
      state._image = images.first;
    });
  }
 
  @override
  void onError(Error error) {
    print("[MyApp]error: $error");
  }
}

class MyLoggerDelegate implements LoggerDelegate {
  static String _getCurrentTime() {
    var now = DateTime.now();
    var formatter = DateFormat('yyyy-MM-dd HH:mm:ss.SSS');
    return formatter.format(now);
  }
 
  @override
  void logInfo(String message) {
    var currentTime = _getCurrentTime();
    print("[$currentTime][INFO]$message");
  }
 
  @override
  void logError(String message) {
    var currentTime = _getCurrentTime();
    print("[$currentTime][ERROR]$message");
  }
 
  @override
  void logWarn(String message) {
    var currentTime = _getCurrentTime();
    print("[$currentTime][WARN]$message");
  }
}
 
Logger.setDelegate(MyLoggerDelegate());

<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>我们需要精确的位置信息来提供准确的服务</string>
<key>NSLocationAccuracy</key>
<string>我们需要精确的位置信息来提供准确的服务</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>我们需要在后台获取您的位置来提供服务</string>
<key>NSCameraUsageDescription</key>
<string>我们需要使用您的相机来拍摄照片</string>

- (IBAction)takePhotoButtonClicked:(UIButton *)sender {
    XHCameraViewConfig *config = [[XHCameraViewConfig alloc] init];
    config.appid = @"your app id";
    config.secretKey = @"your secret key";
    // 如果 needPhotoConfirm = YES，拍完会回调 willDismiss，业务处理完成后需手动调用 dimiss
    config.needPhotoConfirm = NO;
    config.maxImageCount = 9;
    // 资源 bundle 路径
    config.bundlePath = [[NSBundle mainBundle] pathForResource:@"XheyCameraSDKResource" ofType:@"bundle"];
    // 可选：指定团队水印
    // config.groupWatermarkId = @"your group watermark id";
 
    self.cameraViewController = [[XHCameraViewController alloc] initWithConfig:config
                                                                       delegate:self];
    self.cameraViewController.modalPresentationStyle = UIModalPresentationFullScreen;
    [self presentViewController:self.cameraViewController animated:YES completion:nil];
}

- (void)cameraViewController:(XHCameraViewController *)cameraViewController
       didCaptureStillImages:(NSArray<NSData *> *)images {
    NSLog(@"%s %d", __FUNCTION__, __LINE__);
    for (NSInteger i = 0; i < self.imageViews.count; ++i) {
        if (i >= images.count) {
            self.imageViews[i].image = nil;
            continue;
        }
        self.imageViews[i].image = [UIImage imageWithData:images[i]];
    }
}
 
- (void)cameraViewControllerDidCancel:(XHCameraViewController *)cameraViewController {
    NSLog(@"%s %d", __FUNCTION__, __LINE__);
    self.cameraViewController = nil;
}
 
- (void)cameraViewController:(XHCameraViewController *)cameraViewController
            didFailWithError:(NSError *)error {
    NSLog(@"%s %d error: %@", __FUNCTION__, __LINE__, error);
    self.cameraViewController = nil;
}
 
- (void)cameraViewControllerWillDismiss:(XHCameraViewController *)cameraViewController {
    NSLog(@"%s %d", __FUNCTION__, __LINE__);
    [self.cameraViewController dimiss];
}

@interface MyCameraLogger : NSObject <XHCameraLoggerProtocol>
@end
 
@implementation MyCameraLogger
 
- (NSString *)currentTimestamp {
    NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
    [formatter setDateFormat:@"yyyy-MM-dd HH:mm:ss.SSS"];
    return [formatter stringFromDate:[NSDate date]];
}
 
- (NSString *)currentThreadID {
    uint64_t tid;
    pthread_threadid_np(NULL, &tid);
    return [NSString stringWithFormat:@"%llu", tid];
}
 
- (void)logInfo:(NSString *)info {
    NSLog(@"[%@][%@][INFO] %@", [self currentTimestamp], [self currentThreadID], info);
}
 
- (void)logError:(NSString *)error {
    NSLog(@"[%@][%@][ERROR] %@", [self currentTimestamp], [self currentThreadID], error);
}
 
- (void)logWarn:(NSString *)warn {
    NSLog(@"[%@][%@][WARN] %@", [self currentTimestamp], [self currentThreadID], warn);
}
 
@end
 
[XHCameraLogger registerLogger:[MyCameraLogger new]];

android {
    // ...
}
 
repositories {
    flatDir {
        dirs 'libs'
    }
}
 
dependencies {
    implementation(name: 'xheycamerasdk-release', ext: 'aar')
 
    def camerax_version = "1.3.4"
    implementation "androidx.camera:camera-core:${camerax_version}"
    implementation "androidx.camera:camera-camera2:${camerax_version}"
    implementation "androidx.camera:camera-lifecycle:${camerax_version}"
    implementation "androidx.camera:camera-view:${camerax_version}"
}

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-feature android:name="android.hardware.camera" android:required="true" />

private void takePhoto() {
    Intent intent = new Intent(this, CameraActivity.class);
    intent.putExtra(CameraViewConfig.kAppid, "your app id");
    intent.putExtra(CameraViewConfig.kSecretKey, "your secret key");
    intent.putExtra(CameraViewConfig.kMaxImageCount, 9);
    intent.putExtra(CameraViewConfig.kNeedPhotoConfirm, true);
    // 资源路径（对应 app/src/main/assets/XheyCameraSDKAssets）
    String resourceDir = "file:///android_asset/XheyCameraSDKAssets";
    intent.putExtra(CameraViewConfig.kResourceDir, resourceDir);
    // 可选：指定团队水印
    // intent.putExtra(CameraViewConfig.kGroupWatermarkId, "your group watermark id");
 
    EventBus.registerEvent(EventBus.EventName.kCameraActivityWillDismiss, eventBusDelegate);
    someActivityResultLauncher.launch(intent);
}

private final EventBus.EventBusDelegate eventBusDelegate = new EventBus.EventBusDelegate() {
    @Override
    public void onEvent(String event, Object data) {
        Log.d("MainActivity", "onEvent: " + event);
        EventBus.unregisterEvent(EventBus.EventName.kCameraActivityWillDismiss, eventBusDelegate);
        EventBus.EventData.CameraActivityWillDismiss eventData =
                (EventBus.EventData.CameraActivityWillDismiss) data;
        CameraActivity cameraActivity = eventData.cameraActivity;
        CameraActivity.Result result = eventData.result;
        // 业务处理完后手动关闭
        cameraActivity.dismiss();
    }
};

ActivityResultLauncher<Intent> someActivityResultLauncher = registerForActivityResult(
        new ActivityResultContracts.StartActivityForResult(),
        result -> {
            Log.d("MainActivity", "onActivityResult: " + result.getResultCode());
            if (result.getResultCode() == Activity.RESULT_OK) {
                CameraActivity.Result myResult = CameraActivity.getResult();
                if (myResult.error != null) {
                    Log.e("MainActivity", "capture failed", myResult.error);
                    return;
                }
                for (byte[] imageData : myResult.images) {
                    Bitmap bitmap = BitmapFactory.decodeByteArray(imageData, 0, imageData.length);
                    // TODO: 使用 bitmap（展示、上传、保存）
                }
                return;
            }
            if (result.getResultCode() == Activity.RESULT_CANCELED) {
                Log.d("MainActivity", "RESULT_CANCELED");
            }
        });

Logger.setDelegate(new Logger.LoggerDelegate() {
    @Override
    public void logInfo(String tag, String message) {
        Log.i(tag, message);
    }
 
    @Override
    public void logError(String tag, String message) {
        Log.e(tag, message);
    }
 
    @Override
    public void logWarn(String tag, String message) {
        Log.w(tag, message);
    }
});

{
  "NSCameraUsageDescription": "用于拍照",
  "NSLocationWhenInUseUsageDescription": "用于获取拍照地点",
  "NSLocationAlwaysAndWhenInUseUsageDescription": "用于获取拍照地点"
}

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

const xcCameraModule = uni.requireNativePlugin("XCCameraModule");
 
xcCameraModule.takePhotoWithAppId(
  "your app id",
  "your secret key",
  9,          // maxImageCount
  "",         // groupWatermarkId，可选
  true,       // needPhotoConfirm，建议传 true
  (res) => {
    // imageDatas 是 JSON 字符串；解析后每项为 base64 图片（通常带 data:image/jpg;base64, 前缀）
    console.log("capture success:", JSON.parse(res?.imageDatas || "[]"));
 
    // 失败场景可关注：
    // res.error / res.errorCode
  }
);

{
  "plugins": {
    "XCameraWXMiniPlugin": {
      "version": "1.0.60",
      "provider": "wx2978946aed99cf6f"
    }
  }
}

{
  "permission": {
    "scope.camera": {
      "desc": "用于拍照功能"
    },
    "scope.userLocation": {
      "desc": "用于获取位置信息"
    }
  }
}

// 打开相机页面
wx.navigateTo({
  url: 'plugin://XCameraWXMiniPlugin/camera-page',
  events: {
    onPluginResult: (data) => {
      console.log('拍照结果:', data.result)
      console.log('照片信息:', data.userCommentObject)
    }
  }
})

Page({
  data: {
    photoResult: ''
  },
 
  // 打开相机
  openCamera() {
    wx.navigateTo({
      url: 'plugin://XCameraWXMiniPlugin/camera-page',
      events: {
        onPluginResult: this.handlePhotoResult.bind(this)
      }
    })
  },
 
  // 处理拍照结果
  handlePhotoResult(data) {
    if (data.result) {
      this.setData({ photoResult: data.result, userComment:data.userCommentObject })
      wx.showToast({
        title: '拍照成功！',
        icon: 'success'
      })
    } else {
      wx.showToast({
        title: '拍照取消',
        icon: 'none'
      })
    }
  }
})

const params = {
  appid: '',
  noncestr: '',
  timestamp: 1752804199,
  signature: encodeURIComponent(''), //signature可能存在特殊符号，需要提前处理encodeURIComponent
  groupWatermarkId: '', // 使用平台配置的水印
  disableOffcialWatermark: true, // 禁用官方水印
  disableWatermarkDragging: true, // 禁用水印拖拽
  maxImageCount: 3, // 最多拍摄3张
  customInputItems: encodeURIComponent(JSON.stringify([
    { title: '会议名称', content: '自定义会议名称' },
    { title: '会议类型', content: '自定义会议类型' },
    { title: '负责员工', content: 'ABC' }
  ]))
}
 
const query = Object.entries(params)
  .map(([key, value]) => `${key}=${value}`)
  .join('&')
 
wx.navigateTo({
  url: `plugin://XCameraWXMiniPlugin/camera-page?${query}`,
  events: {
    onPluginResult: this.handlePhotoResult.bind(this)
  }
})

    <camera-component
      appid="{{appid}}"
      noncestr="{{noncestr}}"
      timestamp="{{timestamp}}"
      signature="{{signature}}"
      takingPhoto="{{takingPhoto}}"
      disable-photo-confirm="{{false}}"
      enable-custom-watermark="{{false}}"
      watermark-title="会议记录"
      logo-url=""
      flashMode="on"
      cameraPosition="front"
      watermark-scale="1.0"
      disable-offcial-watermark="{{false}}"
      disable-watermark-dragging="{{false}}"
      custom-input-items="{{customInputItems}}"
      group-watermark-id="{{groupWatermarkId}}"
      bind:result="onXcameraResult"
    />

wx.navigateTo({
  url: 'plugin://XCameraWXMiniPlugin/camera-page',
  events: {
    onPluginResult: (data) => {
      console.log('拍照结果:', data.result)
      console.log('照片信息:', data.userCommentObject)
      // data.result 是 Base64 格式的图片数据
    }
  }
})

<camera-component
  bind:result="onXCameraResult"
/>

Page({
  onXCameraResult(e){ 
    const { result, userCommentObject } = e.detail || {}
  },
})

{
  result: "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ..." // Base64图片数据
  userCommentObject: {
    "data": {
        "baseInfo": {
            "altitude": "102.3",
            "decibel": "",
            "captureTimeClock": 0,
            "frontRearCam": "rear",
            "imageDirection": "",
            "isSelfLocation": false,
            "latitude": "39.6937632",
            "location": "北京市通州区·老李草莓釆摘园",
            "locationDetail": "",
            "locationPoi": "",
            "locationType": "4",
            "longitude": "116.7036319",
            "photoNumber": "",
            "screenType": "2",
            "speed": "0",
            "time": "2025:09:02 11:00:24",
            "timeType": "1",
            "timeZone": "-480",
            "ua": {
                "appName": "XCamera-web",
                "appVersion": "1.0.1",
                "manufacturer": "",
                "model": "",
                "os": "",
                "osVersion": ""
            },
            "weather": {
                "type": "阴",
                "temperature": 30
            }
        },
        "fileName": "23f827f8-3376-4d51-b29c-dc58f14cf424.jpg",
        "groupLocation": {
            "groupID": "",
            "locationID": ""
        },
        "groupWatermarkID": "74542b94-ef29-4fff-a9f3-68c5f2823c71",
        "userID": "",
        "watermarkBaseID": 10,
        "watermarkContent": [
 
        ],
        "watermarkContentExtension": {
            "antiFakeCode": "Y62GPC2CEUR6X4"
        },
        "watermarkFromGroupID": "",
        "watermarkFromGroupId": "",
        "watermarkID": "10"
    },
    "ver": "20220209"
  }
}

{
  result: null // 拍照失败或用户取消
}

// go代码示例 HMAC-SHA256 签名，输出格式 Base64
func HmacSign(data string, secret string) (ret string) {
	hmacObj := hmac.New(sha256.New, []byte(groupSecret))
	hmacObj.Write([]byte(data))
	ret = base64.StdEncoding.EncodeToString(hmacObj.Sum(nil))
	return ret
}

generateSignature(params, secret) {
  // 1. 对参数按照 ASCII 字典序排序
  const sortedKeys = Object.keys(params).sort();
 
  // 2. 拼接成 URL 键值对的格式
  const data = sortedKeys.map((key) => `${key}=${params[key]}`).join("&");
 
  // 3. 使用 HMAC-SHA256 进行签名
  const encoder = new TextEncoder();
  const keyData = encoder.encode(secret);
  const messageData = encoder.encode(data);
 
  return crypto.subtle
    .importKey(
      "raw",
      keyData,
      { name: "HMAC", hash: { name: "SHA-256" } },
      false,
      ["sign"]
    )
    .then((key) => {
      return crypto.subtle.sign("HMAC", key, messageData);
    })
    .then((signature) => {
      // 4. 签名结果转换为 Base64
      return btoa(String.fromCharCode(...new Uint8Array(signature)));
    });
}
 
 
const appid = "your appid";
const noncestr = "65cdfefecaf3a0c4"; // 可以随机生成一个字符串
const timestamp = Math.floor(Date.now() / 1000).toString();
const params = {
  appid: appid,
  noncestr: noncestr,
  timestamp: timestamp,
};
 
const secret = "secret";
const signature = await this.generateSignature(params, secret);

<!-- 引入 CryptoJS 库 -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/crypto-js/4.1.1/crypto-js.min.js"></script>
<script>
function generateSignature(params, secret) {
  // 1. 对参数按照 ASCII 字典序排序
  const sortedKeys = Object.keys(params).sort();
 
  // 2. 拼接成 URL 键值对格式
  const data = sortedKeys.map((key) => `${key}=${params[key]}`).join('&');
 
  // 3. 使用 CryptoJS 计算 HMAC-SHA256 签名
  const hash = CryptoJS.HmacSHA256(data, secret);
 
  // 4. 将签名结果转换为 Base64
  const signature = CryptoJS.enc.Base64.stringify(hash);
  return signature;
}
</script>

import hmac
import hashlib
import base64
import argparse
import time
import random
import string
 
# 生成签名的函数
def generate_signature(params, secret):
    # 1. 对参数按照 ASCII 字典序排序
    sorted_keys = sorted(params.keys())
 
    # 2. 拼接成 URL 键值对的格式
    data = "&".join(f"{key}={params[key]}" for key in sorted_keys)
 
    # 3. 使用 HMAC-SHA256 进行签名
    secret_bytes = secret.encode('utf-8')
    data_bytes = data.encode('utf-8')
 
    # 创建 HMAC 对象并进行签名
    signature = hmac.new(secret_bytes, data_bytes, hashlib.sha256).digest()
 
    # 4. 签名结果转换为 Base64
    signature_base64 = base64.b64encode(signature).decode('utf-8')
 
    return signature_base64
 
# 生成随机字符串
def generate_random_string(length=16):
    return ''.join(random.choices(string.ascii_lowercase + string.digits, k=length))
 
# 主函数
def main():
    appid = "your app id"
    secret = "your secret key"
 
    # 生成随机字符串和时间戳
    noncestr = generate_random_string()
    timestamp = str(int(time.time()))  # 获取当前时间戳（秒）
 
    # 构造参数字典
    params = {
        "appid": appid,
        "noncestr": noncestr,
        "timestamp": timestamp
    }
 
    # 生成签名
    signature = generate_signature(params, secret)
 
    # 输出参数和签名
    print(f"appid: {appid}")
    print(f"noncestr: {noncestr}")
    print(f"timestamp: {timestamp}")
    print(f"signature: {signature}")
 
if __name__ == "__main__":
    main()
 

package com.xhey.xheycamerasdk;
 
import android.util.Base64;
 
import java.nio.charset.StandardCharsets;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import java.util.Random;
 
import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
 
public class SignatureUtil {
 
    /**
     * 封装签名结果的实体类
     */
    public static class SignatureResult {
        public int timestamp;    // 修改为 int 类型
        public String noncestr;
        public String signature;
    }
 
    /**
     * 根据 appid 和 secretKey 生成 timestamp、noncestr 和 signature
     *
     * @param appid     应用 ID
     * @param secretKey 密钥
     * @return 签名结果，包括 timestamp、noncestr 和 signature
     */
    public static SignatureResult generateSignature(String appid, String secretKey) {
        SignatureResult result = new SignatureResult();
 
        // 获取当前 Unix 时间戳（秒）并转成 int 类型
        result.timestamp = (int) (System.currentTimeMillis() / 1000);
 
        // 生成随机字符串（noncestr）
        result.noncestr = generateRandomString(16);
 
        // 构造参数字典（键值对），注意需要按照 ASCII 字典序排序
        // 由于参数只有三个，可先放入一个 List 中，然后排序
        List<String> keys = new ArrayList<>();
        keys.add("appid");
        keys.add("noncestr");
        keys.add("timestamp");
        Collections.sort(keys);  // 按 ASCII 顺序排序
 
        // 根据排序后的 key 拼接成 URL 键值对格式
        // 例如：appid=xxx&noncestr=xxx&timestamp=xxx
        StringBuilder dataBuilder = new StringBuilder();
        for (int i = 0; i < keys.size(); i++) {
            String key = keys.get(i);
            String value;
            switch (key) {
                case "appid":
                    value = appid;
                    break;
                case "noncestr":
                    value = result.noncestr;
                    break;
                case "timestamp":
                    value = String.valueOf(result.timestamp);
                    break;
                default:
                    value = "";
            }
            dataBuilder.append(key).append("=").append(value);
            if (i != keys.size() - 1) {
                dataBuilder.append("&");
            }
        }
        String data = dataBuilder.toString();
 
        try {
            // 使用 HMAC-SHA256 算法计算签名
            SecretKeySpec signingKey = new SecretKeySpec(secretKey.getBytes(StandardCharsets.UTF_8), "HmacSHA256");
            Mac mac = Mac.getInstance("HmacSHA256");
            mac.init(signingKey);
            byte[] rawHmac = mac.doFinal(data.getBytes(StandardCharsets.UTF_8));
 
            // 将签名结果进行 Base64 编码
            result.signature = Base64.encodeToString(rawHmac, Base64.NO_WRAP);
        } catch (Exception e) {
            e.printStackTrace();
            result.signature = null;
        }
 
        return result;
    }
 
    /**
     * 生成指定长度的随机字符串（只包含小写字母和数字）
     *
     * @param length 随机字符串长度
     * @return 随机字符串
     */
    private static String generateRandomString(int length) {
        String chars = "abcdefghijklmnopqrstuvwxyz0123456789";
        StringBuilder sb = new StringBuilder(length);
        Random random = new Random();
        for (int i = 0; i < length; i++) {
            sb.append(chars.charAt(random.nextInt(chars.length())));
        }
        return sb.toString();
    }
}
 

{
  "自定义项标题2": "这是自定义项内容2",
  "自定义项标题5": "这是自定义项内容5"
}

<meta name="viewport" content="width=device-width, initial-scale=0.5" />