Appearance

合规使用指南 ​

本指南面向集成小鹅通SDK（鸿蒙端，@xe/webcore）的第三方应用开发者，说明接入、升级、权限声明、初始化时机、隐私披露和用户权利保障的合规要求，帮助您合规使用本 SDK 并保护最终用户的个人信息安全。

一、最新SDK版本说明 ​

请在您的 HarmonyOS 工程中通过 ohpm 接入并保持升级到最新版本的 SDK：

bash
ohpm install @xe/webcore
# 升级到最新版本
ohpm update @xe/webcore
  • SDK 已在 DevEco Studio 5.0.1 Beta3、HarmonyOS SDK 5.0.1（API 13）、ROM 5.0.0.106 环境完成验证；其他版本请以实际测试结果为准。
  • 新版本会持续跟随监管要求调整个人信息处理规则与权限声明，请在发布前确认所用版本为当前最新版本；具体版本号与更新说明以 ohpm 上 @xe/webcore 的发布记录为准。
  • 接入方式与参数说明见小鹅通SDK-鸿蒙端接入文档。

二、权限调用合规要求 ​

SDK 仅声明实现店铺页面服务所必需的系统权限，不声明与功能无关的权限，也不使用其未声明但宿主应用已申请的权限。接入方应在宿主工程的 module.json5 中同步声明下述两项权限，并在隐私政策中如实告知。

权限名称权限说明使用目的权限申请时机
ohos.permission.INTERNET允许应用访问网络并进行数据传输用于小鹅通SDK 相关网络服务，加载店铺页面与请求业务接口展示店铺页面、调用在线业务接口时
ohos.permission.MICROPHONE访问麦克风以录制音频用于录音打卡、录音功能最终用户主动触发录音时，按需申请运行时权限

说明：

  • 上述两项为鸿蒙端仅有的权限。《小鹅通SDK个人信息保护政策》“应用权限说明”中标注的 Android 权限（文件读取、文件写入、相机、前台服务、音频录制、读取设备信息等）在鸿蒙端均不涉及。
  • 麦克风权限为运行时权限，仅在最终用户主动触发录音打卡、录音功能时按需申请，未使用该能力的应用不应声明。
  • 鸿蒙端不集成腾讯浏览服务 SDK，因此不涉及该 SDK 所需的权限。
  • 如需核对 SDK 的实际声明，请以 SDK 当前版本随包提供的 module.json5 为准。

三、延迟初始化要求 ​

为避免在最终用户同意隐私政策前提前处理个人信息，请在获得用户同意后再初始化 SDK。XESDK.init 会建立 SDK 运行环境，必须在隐私政策同意之后调用，并早于首次展示店铺页面的时机。

ts
import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit'
import { XESDK } from '@xe/webcore'

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    // 请在用户同意隐私政策后再执行初始化
    XESDK.init({
      appId: '从小鹅通获取的 app_id',
      clientId: '从小鹅通获取的 client_id',
      showLog: false
    })
  }
}

推荐调用时序：

  1. 应用首次启动，展示隐私政策并获取用户同意；
  2. 用户同意后调用 XESDK.init 完成初始化；
  3. 用户进入店铺相关页面时，创建 XEWeb 并传入店铺 URL 展示页面；
  4. 宿主应用已有有效登录态时，在首次展示前调用 XESDK.preSync 同步登录态。

用户拒绝隐私政策时，不应调用 XESDK.init，也不应加载店铺页面。

四、最小化使用功能要求 ​

本 SDK 不涉及扩展业务功能的独立开关，也不涉及个人信息收集频次、精度的配置项。相册选图与录音属于可选个人信息，SDK 通过初始化参数 optionalCapabilities 提供对应开关，默认开启，未使用对应功能时应关闭，配置方式见下一节。最小化使用通过仅声明 ohos.permission.INTERNET 与 ohos.permission.MICROPHONE 两项权限、并在最终用户主动触发录音功能时按需申请麦克风权限来实现。

五、可选个人信息配置方式 ​

相册选图与录音仅在宿主业务实际使用对应功能、且由最终用户主动操作时才会触发。未使用对应功能的宿主，应在初始化 SDK 时关闭该项，并从 module.json5 中移除对应权限声明。这两项分别对应《小鹅通SDK个人信息保护政策》“个人信息字段说明”中的图片信息与音频信息，是否必选均为“否”。

  • 相册图片/视频：最终用户主动点击上传控件，在系统图片选择器中选定图片后，由业务流程将所选图片上传至小鹅通服务端。默认开启，通过 optionalCapabilities.chooseImage: false 关闭；走系统图片选择器、由用户在界面上当面授权，无需声明媒体文件读权限。
  • 麦克风音频：最终用户主动触发录音功能时采集并上传语音。默认开启，通过 optionalCapabilities.recordAudio: false 关闭；关闭后应从 module.json5 中移除 ohos.permission.MICROPHONE。

SDK 不会主动拉起选择器或申请权限：chooseImage、startRecord 只在最终用户操作后由页面调用；麦克风权限在录音开始前按需申请，用户拒绝授权后 SDK 不再重复申请，也不会自动跳转系统设置页。

配置示例（仅使用相册选图、不使用录音的宿主）：

ts
XESDK.init({
  appId: '从小鹅通获取的 app_id',
  clientId: '从小鹅通获取的 client_id',
  showLog: false,
  optionalCapabilities: {
    chooseImage: true,
    recordAudio: false
  }
})

module.json5 的 requestPermissions 按宿主是否使用录音能力二选一。

不使用录音能力，只声明网络权限：

json5
"requestPermissions": [
  { "name": "ohos.permission.INTERNET" }
]

使用录音能力，同时声明麦克风权限：

json5
"requestPermissions": [
  { "name": "ohos.permission.INTERNET" },
  { "name": "ohos.permission.MICROPHONE" }
]

关闭后若页面仍调用被关闭的能力，SDK 会向用户给出提示（如“图片选择功能暂不可用”），并向页面返回失败结果，不会拉起系统界面，也不会申请权限。

六、隐私政策披露要求与示例说明 ​

在您接入、使用小鹅通SDK 服务前，我们要求您在隐私政策中向用户告知 SDK 名称、SDK 提供方名称、收集个人信息类型、使用目的、隐私政策链接，并获取用户的同意或取得其他合法性基础。您可以参考如下方式提供条款内容。

以文字方式向用户告知 ​

  • 第三方SDK名称：小鹅通SDK
  • 第三方公司名称：深圳小鹅网络技术有限公司
  • 收集个人信息类型：
    • 图片信息（可选）：最终用户在图片打卡、作业提交等场景中主动选择上传的图片
    • 音频信息（可选）：最终用户使用录音打卡、录音功能时录制的音频
  • 使用目的：在第三方应用中提供小鹅通店铺的页面访问与业务能力（账号打通、内容交付与分销、支付营销、直播课程、页面分享、外链处理等 Web 交互），并提供图片打卡、作业提交的图片上传，以及录音打卡、录音功能
  • 隐私政策链接：《小鹅通SDK个人信息保护政策》

以表格方式向用户告知 ​

第三方SDK名称第三方公司名称收集个人信息类型使用目的隐私政策链接
小鹅通SDK深圳小鹅网络技术有限公司图片信息（图片打卡、作业提交等场景中主动上传的图片）、音频信息（录音打卡、录音功能录制的音频），均标注为可选提供小鹅通店铺页面访问与业务能力（账号打通、内容交付与分销、支付营销、直播课程、页面分享、外链处理等 Web 交互），以及图片打卡、作业提交的图片上传、录音打卡、录音功能查看

角色说明：在此场景中，第三方应用提供者作为数据控制者决定用户数据的处理目的和方式，小鹅通SDK 作为数据处理者，接受您的委托并根据您的指示处理用户数据。更多说明见小鹅通SDK开发者声明。

建议在您的隐私政策中增加以下条款，或以其他方式获得用户同意：

“我们的产品或服务可能包括第三方的产品或服务，也可能收集并使用您的个人信息。例如，我们为实现__________服务集成 小鹅通SDK，小鹅通将作为数据处理者，按照本公司的指示收集处理您的数据，小鹅通将按照《小鹅通SDK个人信息保护政策》（附链接）所述收集、处理、保护您的个人信息。”

七、最终用户授权同意的建议方式 ​

  1. 首次启动统一告知：应用首次启动时展示隐私政策摘要与同意入口，逐项列明集成的第三方 SDK；用户点击同意后再进入下一步。
  2. 拒绝的后果可预期：用户拒绝隐私政策时，仅提供不依赖小鹅通SDK 的基础功能，或明确告知无法使用店铺相关功能，不得因此阻断整个应用。
  3. 功能触发时再次说明：用户首次触发录音、语音等能力时，通过系统权限弹窗与页面提示说明用途，仅在用户主动触发时申请，不在启动阶段批量申请。
  4. 单独同意的场景：涉及处理敏感个人信息、向中华人民共和国境外提供个人信息时，应通过单独弹窗等方式取得最终用户的单独同意，并在弹窗中显著提示信息类型、目的与接收方。
  5. 变更后的重新告知：SDK 升级带来个人信息处理规则变化时，应更新隐私政策并重新获取同意。

八、保障个人信息主体权利 ​

为保障最终用户便捷地实现访问、更正、删除个人信息以及撤回同意的权利，请结合 SDK 提供的能力与您自身的账号体系实现：

  • 退出登录或切换账号：调用 await XESDK.syncNot() 清除 SDK 内的登录态与相关 Cookie，保证上一个账号的数据不再被当前用户访问。
  • 查询与更正：店铺侧的账号信息、订单与学习记录等数据，通过小鹅通店铺管理台或您已对接的小鹅通技术支持渠道发起查询与更正。
  • 删除与撤回同意：用户撤回隐私政策同意或注销账号后，停止调用 XESDK.init 并清除登录态；账户数据的删除按《小鹅通SDK个人信息保护政策》与小鹅通店铺侧流程处理。
  • 响应时限：请将最终用户的个人信息权利请求转达至上述渠道，并按法律法规要求的时限答复用户。

相关文档 ​