MSDK 开发者合规指引

生效日期：2022-06-09

更新日期：2024-10-14

更新内容：增加网页麦克风权限说明；Pix 版本依赖库说明

 

尊敬的开发者：

非常感谢您选择在您所开发的产品中集成 MSDK（以下简称“本产品”）的产品和服务！

根据监管部门要求，开发者在终端用户同意《隐私政策》前不得处理个人信息，并且当产品中使用第三方SDK时应告知该第三方SDK收集终端用户个人信息的目的、范围、方式等详情并取得终端用户同意。我们（本指引中具体指“深圳市腾讯计算机系统有限公司”，以下简称“腾讯”或“我们”）面向腾讯内部产品（APP）开发项目组（以下简称“项目组”）以及腾讯以外的指定合作伙伴（以下简称“第三方开发者”。“项目组”和“第三方开发者”统称为“您”或“开发者”。）提供服务，请您务必按照以下步骤做好合规自查，以满足各项法规的要求。特别地，当您作为第三方开发者将MSDK集成至您所开发的产品中时，您还需满足相应的信息披露及用户同意要求，请参照本指引第2条在您的产品中完成相应配置。

 

1.    保持最新版本 

请前往 MSDK（V3 版本） 或 GCloud 官网（V5 版本） 查看和下载最新版本 SDK

 

2.    《隐私政策》中添加相关说明

请您确保您开发或运营的应用有符合监管要求的《隐私政策》文本。如您是第三方开发者，请您同时务必明确告知终端用户您的产品中使用了腾讯所提供的 MSDK 服务。建议第三方开发者在《隐私政策》对应的章节、列表中添加《第三方信息共享清单》或《第三方SDK目录》，并在其中加入关于 MSDK 的说明，推荐条款如下：

 

SDK 名称：MSDK

第三方名称：深圳市腾讯计算机系统有限公司

SDK 用途：在移动端设备进行账号登录、好友分享、数据上报等功能（请您根据实际接入使用情况填写）

SDK 个人信息类型：（请您根据实际接入使用情况填写）

官网链接（根据版本进行选择）：

l  V3： https://wiki.ssl.msdk.qq.com/index.html

l  V5：https://docs.msdk.qq.com/v5/zh-CN

隐私政策链接：https://img.ssl.msdk.qq.com/privacy/privacy.html

 

说明：您在使用我们 SDK 产品时，所请求使用的权限、收集的设备信息会因为接入组件情况有所不同。您应对实际收集的个人信息向用户进行说明。具体收集使用个人信息情况详见 《MSDK个人信息保护规则》。

 

3.    为实现SDK产品功能所需的权限

为实现SDK产品的相应功能所必须,我们会通过开发者的应用申请所需权限。

 

4.    隐私合规处理流程

4.1.    整体流程

为满足合规要求，参考以下整体流程进行合规处理  ：

 

 

4.2.    MSDK V3

4.2.1.   可选功能接入说明

MSDK 的功能可以实现插件化、开关等形式实现功能选择，开发者可以根据自身需需要进行选择，以满足业务需求。

 

4.2.2.   应用启动

请您确保此刻不立即初始化 MSDK，需要在用户同意隐私政策的之后进行初始化操作。

 

4.2.3.   展示隐私政策及权限说明

请您务必确保终端用户首次启动 App 时，通过弹窗的方式向用户披露和展示隐私政策并征询用户有效同意。

l  隐私政策披露及处理方式

请您在《隐私政策》中披露通过MSDK所采集的个人信息种类及使用目的。如果您是第三方开发者，请您务必明确告知终端用户您的应用使用了腾讯提供的 MSDK 服务。建议第三方开发者在《隐私政策》对应的章节、列表中添加《第三方信息共享清单》或《第三方SDK目录》，并在其中加入关于 MSDK 的说明。具体可以参考 2.《隐私政策》中添加相关说明 。

 

l  权限披露及处理方式

请您根据自身实际接入和使用情况，依照《MSDK个人信息保护规则》进行相应的权限说明披露，并征得用户同意。请注意申请频次，避免频繁申请造成用户打扰。

 

MSDK 提供了 Policy 组件（Android），可以帮助业务实现隐私协议弹窗的一般流程，具体请参考：https://wiki.ssl.msdk.qq.com/Android/config.html#Android_DataCompliance

 

4.2.4.   数据合规接口调用

MSDK 新版本已经支持个人信息开关以及设置，您可自由控制合规采集的时机。请您在征得用户有效同意后且在调用 MSDK 初始化接口之前，按以下步骤依次进行：

l  【必须】开启设备信息采集，用于开启 MSDK 内置隐私合规相关逻辑。不开启将导致内部逻辑无法完全正常进行。

l  【可选】设备信息独立开关设置，可独立控制 MSDK 内部特定字段的采集情况。

l  【可选】设备信息设置，开发者可以自行传入特定字段，以替代 MSDK 内部数据采集。

 

同时，您需注意，您的产品应仅在满足业务功能所需要的最小必要范围内采集个人信息。对于超出最小必要范围的个人信息，应关闭相应的采集开关或接口，以避免超范围采集个人信息。

 

4.2.4.1.  开启设备信息采集

请您在征得用户有效同意后，调用开启设备信息采集开启设备信息采集。MSDK 支持通过函数调用的方式来开启  MSDK 设备信息采集。

接口调用

MSDK 提供了 Java 接口以满足开发者需要，用于设置允许 MSDK 开启或关闭设备信息采集。

// Java 位于 MSDKSensitive 类中，true 表示开启采集；false 表示不允许采集

public static void setCouldCollectSensitiveInfo(boolean couldCollect);

 

以下代码片段展示了用户同意隐私政策后，开启 MSDK 设备信息采集的功能：

void onPolicyConfirmedByUser() {

    ...

    MSDKSensitive.setCouldCollectSensitiveInfo(true);

    ...

}

 

4.2.4.2.  【可选】设备信息独立开关

您有两种方式详细控制 MSDK 采集的特定字段：

1、 配置开关，可以通过配置文件进行开关控制

2、 接口调用，在完成开启设备信息采集（setCouldCollectSensitiveInfo = true）之后调用配置接口接口。

目前支持字段情况如下：

 

l  配置开关

在 msdkconfig.ini 中，增加或修改配置项 MSDK_DENIED_COLLECT_LIST，该配置项为不允许采集的特定字段列表。

例如不采集 Apn ，参考配置示例如下：

// 配置项位于 msdkconfig.ini，默认不允许采集的字段列表为空，多个字段使用英文逗号连接，如：

MSDK_DENIED_COLLECT_LIST = Apn

 

l  接口调用

开发者也可以通过代码调用的方式来进行特定字段的采集开启或关闭，目前仅支持 Android Java 层接口，定义如下：

// 参数示例: {"AndroidID":true,"Apn":true,"QImei":true,"QImei36":true} 

// 说明：true 表示允许采集；false 表示不允许采集；

// Java 位于 MSDKSensitive 类中

public static void setCollectSensitiveInfo(String jsonInfo);

 

例如不采集 Apn 和 AndroidID，参考配置示例如下：

void onShowPolicyResult() {

    ...

    String jsonInfo = "{\"Apn\":false,\"AndroidID\":false}";

    MSDKSensitive.setCollectSensitiveInfo(jsonInfo);

    ...

}

 

优先级说明：

一般地，在未进行配置设置或代码调用的情况下，MSDK 将按默认值（开启）进行内部逻辑处理；

特别地，在开发者做了配置设置且进行了代码调用的情况下，MSDK 将按按照 代码接口 > 配置文件 > 默认值（开启）的优先级顺序来决定是否开启采集特定字段。

 

4.2.4.3.  【可选】设备信息设置

MSDK 新版本已经支持设备信息的设置功能。如您自身已经采集了对应数据，则可以通过 2. 设备信息独立开关 关闭 MSDK 内置设备信息采集，并传入设备信息，MSDK 则会以传入的设备信息进行功能逻辑处理。

目前支持 AndroidID，WiFiMacAddress，Model，Oaid，Imsi，Cid 特定字段。

l  接口调用

开发者可以通过以下代码传递您采集的信息供 MSDK 使用：

// 参数示例：

// {"AndroidID":"xxx", "WiFiMacAddress":"xxx",  "Model":"xxx", "Oaid":"xxx", "Imsi":"xxx", "Cid":"xxx"}

// Java 位于 MSDKSensitive.java 类中

public static void setSensitiveInfo(String jsonInfo);

 

以下代码片段演示了如何传递您采集的 AndroidID  给 MSDK 使用：

void onShowPolicyResult() {

    String jsonInfo ="{\"AndroidID\":\"xxxxxxxxxx\"}";

    MSDKSensitive.setSensitiveInfo(jsonInfo);

}

 

4.2.5.   初始化 MSDK

请您务必确保终端用户首次启动 App 时，通过弹窗等明显方式提示用户阅读您 App 的《隐私政策》并获得终端用户有效同意之后再初始化 MSDK。

如果没有初始化 MSDK，将无法使用 MSDK 提供的服务。MSDK V3 初始化接口如下：

// Android

WGPlatform.Initialized(this, baseInfo);

 

// iOS

WGPlatform::GetInstance();

 

// Unity C#

WGPlatform.Instance.Init();

 

至此，MSDK V3 版本的合规流程已介绍完毕。

 

4.3.    MSDK V5

4.3.1.   可选功能接入说明

MSDK 的功能可以实现插件化、开关等形式实现功能选择，开发者可以根据自身需需要进行选择，以满足业务需求。

 

4.3.2.   PIX 版本库依赖说明

MSDKPIX 版本依赖 PixUI 基础框架库，具体情况如下：

 

4.3.3.   应用启动

请您确保此刻不立即初始化 MSDK，需要在用户同意隐私政策的之后进行初始化操作。

 

4.3.4.   展示隐私政策及权限说明

请您务必确保终端用户首次启动 App 时，通过弹窗的方式向用户披露和展示隐私政策并征询用户有效同意。

l  隐私政策披露及处理方式

请您在《隐私政策》中披露通过MSDK所采集的个人信息种类及使用目的。如果您是第三方开发者，请您务必明确告知终端用户您的应用使用了腾讯提供的 MSDK 服务。建议第三方开发者在《隐私政策》对应的章节、列表中添加《第三方信息共享清单》或《第三方SDK目录》，并在其中加入关于 MSDK 的说明。具体可以参考 2.《隐私政策》中添加相关说明 。

 

l  权限披露及处理方式

请您根据自身实际接入和使用情况，依照《MSDK个人信息保护规则》进行相应的权限说明披露，并征得用户同意。请注意申请频次，避免频繁申请造成用户打扰。

在此阶段，MSDK 提供了 Policy 组件（Android），可以帮助业务实现隐私协议弹窗的一般流程，具体请参考：https://docs.msdk.qq.com/v5/zh-CN/Access/Android.html

 

4.3.5.   数据合规接口调用

MSDK 新版本已经支持个人信息开关以及设置，业务可自由控制合规采集的时机。请您在征得用户有效同意后且在调用 MSDK 初始化接口之前，按以下步骤依次进行：

l  【可选】设备信息场景设置，可以控制 MSDK 功能场景下的数据采集。

l  【必须】开启设备信息采集，用于开启 MSDK 内置隐私合规相关逻辑。不开启将导致内部逻辑无法完全正常进行。

l  【可选】设备信息独立开关设置，可独立控制 MSDK 内部特定字段的采集情况。

l  【可选】设备信息设置，开发者可以自行传入特定字段，以替代 MSDK 内部数据采集。

 

同时，您需注意，您的产品应仅在满足业务功能所需要的最小必要范围内采集个人信息。对于超出最小必要范围的个人信息，应关闭相应的采集开关或接口，以避免超范围采集个人信息。

 

4.3.5.1.  【可选】设备信息场景配置

MSDK 新版本对上报的设备信息进行了场景区分。如果您接入的是 MSDKV5 版本，您还可以根据自身需求在 MSDKConfig.ini 配置文件中，通过以下开关配置控制具体场景下的设备信息字段上报：

 

4.3.5.2.  开启设备信息采集

请您在征得用户有效同意后，调用开启设备信息采集开启设备信息采集。MSDK 支持通过函数调用的方式来开启  MSDK 设备信息采集。

l  接口调用

MSDK 提供了以下接口以满足开发者需要，用于设置允许 MSDK 开启设备信息采集。

// Java 位于 MSDKSensitive.java 类中

public static void setCouldCollectSensitiveInfo(boolean couldCollect);

 

// C++

static void GCloud::MSDK::MSDKSensitive::SetCouldCollectSensitiveInfo(bool couldCollect);

 

// C#

// 位于 MSDKSensitive.cs 类中

public static void SetCouldCollectSensitiveInfo (bool couldCollect);

 

 

以下代码片段展示了在 Android 场景下，用户同意隐私政策后，开启 MSDK 设备信息采集的功能：

void onPolicyConfirmedByUser() {

    ...

    MSDKSensitive.setCouldCollectSensitiveInfo(true);

    ...

}

 

 

4.3.5.3.  【可选】设备信息独立开关

您有两种方式详细控制 MSDK 采集的特定字段：

1.     配置开关，可以通过配置文件进行开关控制

2.     接口调用，在完成开启设备信息采集（setCouldCollectSensitiveInfo = true）之后调用配置接口接口。

目前支持字段情况如下：

l  配置开关

在 MSDKConfig.ini 中，增加或修改配置项 MSDK_DENIED_COLLECT_LIST，该配置项为不允许采集的特定字段列表。

例如不采集 Apn 和 AndroidID，参考配置示例如下：

// 配置项位于 msdkconfig.ini，默认不允许采集的字段列表为空，多个字段使用英文逗号连接，如：

MSDK_DENIED_COLLECT_LIST = Apn,AndroidID

 

l  接口调用

开发者也可以通过代码调用的方式来进行特定字段的采集开启或关闭，目前支持以下接口：

// 参数示例：{"AndroidID":true,"Apn":true}  说明：true 表示允许采集；false 表示不允许采集；

// Java 位于 MSDKSensitive.java 类中

public static void setCollectSensitiveInfo(String jsonInfo);

 

// C++

static void GCloud::MSDK::MSDKSensitive::SetCollectSensitiveInfo(const String &jsonInfo);

 

// C#

// 位于 MSDKSensitive.cs 类中

public static void SetCollectSensitiveInfo (string jsonInfo);

 

 

以下代码展示了 Android 场景下不采集 Apn 的调用示例：

void onShowPolicyResult() {

    ...

    String jsonInfo = "{\"Apn\":false}";

    MSDKSensitive.setCollectSensitiveInfo(jsonInfo);

    ...

}

 

优先级说明：

一般地，在未进行配置设置或代码调用的情况下，MSDK 将按默认值（开启）进行内部逻辑处理；

特别地，在开发者做了配置设置且进行了代码调用的情况下，MSDK 将按按照 代码接口 > 配置文件 > 默认值（开启）的优先级顺序来决定是否开启采集特定字段。

 

其他字段

MSDK V5 其他字段通过 TDM 获取，开发者如需关闭，请联系 TDM 咨询；

 

4.3.5.4.  【可选】设备信息设置

MSDK 新版本已经支持设备信息的设置功能。如您自身已经采集了对应数据，则可以通过 2. 设备信息独立开关 关闭 MSDK 内置设备信息采集，并传入设备信息，MSDK 则会以传入的设备信息进行功能逻辑处理。

目前支持 AndroidID，WiFiMacAddress，Model，Oaid，Imsi，Cid 特定字段。

l  接口调用

// 参数示例：

// {"AndroidID":"xxx", "WiFiMacAddress":"xxx", "Model":"xxx", "Oaid":"xxx", "Imsi":"xxx", "Cid":"xxx"}

// Java 位于 MSDKSensitive.java 类中

public static void setSensitiveInfo(String jsonInfo);

 

// C++

static void GCloud::MSDK::MSDKSensitive::SetSensitiveInfo(const String &jsonInfo);

 

// C#

// 位于 MSDKSensitive.cs 类中

public static void SetSensitiveInfo (string jsonInfo);

 

 

以下代码片段演示了 Android 场景下，如何传递您采集的 AndroidID 给 MSDK 使用：

void onShowPolicyResult() {

    String jsonInfo ="{\"AndroidID\":\"xxxxxxxxxx\"}";

    MSDKSensitive.setSensitiveInfo(jsonInfo);

}

 

 

4.3.6.   初始化 MSDK

请您务必确保终端用户首次启动 App 时，通过弹窗等明显方式提示用户阅读您 App 的《隐私政策》并获得终端用户有效同意之后再初始化 MSDK。

如果没有初始化 MSDK，将无法使用 MSDK 提供的服务。如果您接入了 GCloudSDK，请参考 GCloud 文档完成 MSDK 初始化。

以下是 MSDK V5 初始化接口：

// Android

MSDKPlatform.initialize(this);

 

// iOS

GCloud::MSDK::MSDK::GetInstance()->Initialize(NULL);

 

// Unity

MSDK.Init();

 

// UE4

// 如果您接入了 GCloudSDK，请参考 GCloud 文档完成 MSDK 初始化

 

 

至此，MSDK V5 版本的合规流程已介绍完毕。

 

5.    常见问题及解答

5.1.    如何处理新版本中 TPNS 相关的厂商推送通道（华为、小米、VIVO、魅族）的 SDK ？

当前华为、小米、VIVO、魅族等厂商推送通道的 SDK 为腾讯外部组件，为降低合规风险，MSDK 默认不再开启相关功能。业务如果有相关需求，可以参考 MSDK 开发文档进行插件接入，但需要自行评估合规相关风险。

注意：如后续腾讯游戏与厂商推送通道达成隐私合规相关协议，MSDK 会继续提供对应功能，请关注 MSDK 后续版本信息。

 

5.2.    无法使用手Q OpenSDK 的各项功能。日志中会报错“用户未授权，暂时无法使用 QQ 登录及分享等功能”

手Q OpenSDK 3.5.7版本开始更新了权限相关功能，接入方在调用 setCouldCollectSensitiveInfo 授权前，无法使用手Q OpenSDK 的各项功能。如您需要使用手Q 相关功能，您必须先通过调用 MSDKSensitive.setCouldCollectSensitiveInfo(true) 接口授权手Q开启设备信息采集，以支持相应能力。

 

5.3.    关于灯塔数据统计和算法效果的说明

灯塔的部分功能受 AndroidID 和 Model 的影响，我们建议尽量保留这两个字段。如果需要删除，请确保已经充分了解其影响。

另外，

如果您接入的是 MSDKV3 版本，您需要了解：

l  MSDKV3 版本使用灯塔（Beacon）SDK 使用 QIMEI SDK 功能；

l  如果您想关闭灯塔（Beacon）SDK 和 QIMEI SDK 的功能，您可以在 msdkconfig.ini 配置文件中添加以下配置：

CLOSE_BEACON_REPORT=true

 

 

l  如果您想删除灯塔组件，删除灯塔组件的同时，需要在 msdkconfig.ini 文件中添加以下配置以关闭灯塔组件和 QImei、QImei36 等字段的采集：

CLOSE_BEACON_REPORT=true

MSDK_DENIED_COLLECT_LIST=QImei,QImei36

 

如果您接入的是 MSDKV5 版本，您需要了解：

l  MSDKV5 版本通过 TDM 自带的 QIMEI SDK 实现 QIMEI SDK 的功能；

l  MSDKV5 版本提供了 MSDKBeacon 插件为业务提供数据上报能力，如果您想删除 灯塔 SDK 和 QIMEI SDK，可以将 MSDKBeacon 插件整个删除即可。

 

5.4.    减少 App 信息采集总次数

如果 App 已经采集了这些字段，想要通过传入的方式减少 App 采集总次数，则可以在 设备信息独立开关 章节关闭对应字段的采集，可以参考 设备信息设置 章节，并通过 MSDKSensitive.setSensitiveInfo(jsonInfo) 接口，将您采集到的 AndroidID 和 Model 信息传递给 MSDK 内部使用。

 

感谢您阅读 MSDK 开发者合规指引，并欢迎您给我们提出建议！如果您有任何疑问，请随时与我们联系！