一、概述

System 是 Android 和 iOS 的系统分享组件，当业务调用 Friend 模块，传入 System 渠道后，会拉起系统分享页面，用户可以选择要分享到的第三方应用进行分享。

iOS 支持最低系统版本： iOS 8

二、工程配置

2.1 Android FileProvider 说明

Android 如果游戏需要用到分享图片功能，需要加上如下配置

1. 在 AndroidManifest 中检查如下配置，若无则增加：

    <application>
   ...
        <provider
            android:name="com.tencent.gcloud.msdk.system.SystemFileProvider"
            android:authorities="${applicationId}.system.provider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/system_share_storage" />
        </provider>
   ...
    </application>
   

   其中，将 {applicationId} 替换成游戏的包名

2. 在 res 目录下增加 xml 目录，并在 xml 目录下添加文件 system_share_storage.xml，xml 中内容示例如下：

   <paths xmlns:android="http://schemas.android.com/apk/res/android">
      <root-path name="root_path" path="."/>
      <files-path name="system_files" path="."/>
      <external-files-path name="system_external" path="." />
   </paths>
   

2.2 iOS 配置说明

需要依赖 MessageUI.framework

三、功能说明

3.1 好友模块分享说明

System 分享，支持文本、图片和链接(仅 iOS)分享类型。

支持类型列表

说明：

1. 每一种分享类型中，填写其他的字段，如文本分享的 Link、ImagePath 字段内容不会被用到；
2. Android 系统分享的 Title 字段，用作拉起系统分享界面的标题显示；iOS 分享界面的标题显示分享内容，因为 iOS 只能设置一份文本内容
3. 系统分享的回调，仅说明拉起系统分享页面的成功与否，不能说明玩家实际分享成功与否；

3.2 分享效果

1）Android

• 调用接口、拉起系统分享的弹框
  

• 点击朋友圈分享，弹出分享框
  

• 分享完成后
  

2）iOS

• 调用接口、拉起系统分享的弹框
  

• 点击 qq，选择空间分享并分享到空间后
  

• 分享完成后，分享界面消失，给出系统分享的回调
  

3.3 iOS 系统分享用户设置说明

iOS 拉起系统分享后，根据不同的 iOS 系统版本，系统默认显示在拉起分享界面的应用不同，一般都是不完整的。这些都是系统的显示控制，用户可以选择和设置的。

• 比如在 ios12 的 ipad 设备上

  • 可以在拉到最右，在更多...中设置显示其他应用，如图
    

  • 可以将经常分享的应用添加到默认拉起面板，如图
    

  • 添加后，如图
    

• 在 ios 13 的 iphoneX 设备上

  • 可以在拉到最右，在更多...中选择其他应用，如图
    

  • 点击更多...后可选择想要分享的应用，如图