集成方式

更新时间: 2023/11/13 09:26:41

集成方式

导入SDK

参照下图将unitypackage导入到自己的项目中:

SDK导入

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

  • unitypackage后缀文件不支持中文路径,请将文件放在全英文路径下。
  • 如果遇到这种错误“The type or namespace name 'JsonProperty' could not be found (are you missing a using directive or an assembly reference?)”,请在Unity项目中Packages目录下的manifest.json文件中增加包依赖"com.unity.nuget.newtonsoft-json": "2.0.0",

Android 项目设置

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

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

xml<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工程的编译配置
  • 添加Other Linker Flags配置:-lstdc++

  • 添加系统库:

    Security.framework

    CoreTelephony.framework

    SystemConfiguration.framework

    JavaScriptCore.framework

    libz.tbd

    libsqlite3.tbd

    注意: 如果项目中已有某些系统库,就不需要重复添加了

  • 修改Build Settings设置

    在TARGETS下选择编译的目标配置,切换到Build Settings选项卡,修改配置如下:

    注意: 在使用旧版本的Unity工具,Windows下生成的Xcode工程,可能会出现下面的问题: Build Settings选项卡, Search Paths -> Library Search Paths 其中一个路径分隔符,是"", 需要修改为"/"。

    修改如下:

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使用麦克风?

此文档是否对你有帮助?
有帮助
去反馈
  • 集成方式
  • 导入SDK
  • Android 项目设置
  • iOS 项目设置
  • 1. iOS 项目配置
  • 1.1 在Unity中修改项目的编译设置(Build Settings)
  • 1.2 在Xcode中修改导出的iOS工程的编译配置
  • 2. 注意事项
  • 2.1 Bitcode
  • 3 隐私权限及相关设置