集成方式

下载并导入SDK

首先在网易云信SDK下载页面获取Unity SDK,参照下图将unitypackage导入到自己的项目中:

SDK导入

导入时,选择里面所有的文件(如果之前使用过旧版本,请务必先删除旧版本相关的文件)。

注意: unitypackage后缀文件不支持中文路径,请将文件放在全英文路径下。

Android 项目设置

网易云信Unity SDK支持的 Andorid 系统版本: 4.0 及以上。

导入 SDK 后,在 Plugins/Android/ 目录下,可以看到 AndroidManifest里SDK 所需权限:

<uses-permission android:name="android.permission.INTERNET" />
<!-- Getting the state of internet for app!!!. --> 
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- write or read user data file for app!!!. -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_LOGS" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>

开发者需要将这些SDK权限添加到自己APP的AndroidManifest里。

iOS 项目设置

1. iOS 项目配置

支持 iOS 系统版本:iOS 8.0及以上。

导出iOS项目时,必须修改如下设置项才能正常使用。不发布到iOS平台可略过此部分。

1.1 在Unity中修改项目的编译设置(Build Settings)

按下Ctrl+Shift+B打开Build Settings面板,点击Player Settings ...,切换到Setting for iOS选项卡,选择Other Settings栏, 修改Optimization配置项Script Call Optimization的值为Slow and Safe

1.2 在Xcode中修改导出的iOS工程的编译配置

2. 注意事项

如果Unity SDK是手动配置的话,下面还有几个问题需要注意:

2.1 Bitcode

如果在编译Xcode时,提示bitcode问题,则关闭bitcode或者在Unity里也配置好支持bitcode。

Unity 4.6.9之前的版本不支持bitcode的设置,但是生成的Xcode工程,使用Xcode7打开就会提示bitcode的错误,因为Xcode7默认是开启bitcode的。

3 隐私权限及相关设置

iOS 10要求开发者添加权限申请的描述,否则程序在iOS 10上会出现崩溃。开发者需要用到语音消息,那么就应该添加麦克风权限申请的描述。有两种方式可以添加:

  1. 在Unity的最新版本中,Player Settings页面中就可以添加描述信息。

  2. 在Xcode项目中找到info.plist,打开并添加以下键值对:

    key:Privacy - Microphone Usage Description

    value: 是否允许此app使用麦克风?