初始化

---

1 简介

集成 SDK 完成后，要想使用 SDK 的功能，还需要对 SDK 进行初始化操作。

建议开发者在初始化 App 的同时，初始化 SDK。

2 步骤

2.1 导入 SDK 头文件

导入SDK初始化的头文件：

#include "AudioRoom.h"
#include "AudioRoom-Publisher.h"
#include "AudioRoom-Player.h"
#include "AudioRoom-IM.h"

2.2 初始化

初始化 SDK 时必须要做的事情：

1. 设置 userID 和 userName。
2. 设置回调对象指针。

请注意：

1. userID 和 userName 来自于 App 自定义的账号系统。
2. AppID 和 AppSign 由 Zego 分配给各 App。为了安全考虑，建议将 AppSign 存储在 App 的业务后台，使用时从后台获取。

建议在初始化前做的事情：

1. 设置测试环境。切换为测试环境后，开发者会使用由 Zego 提供的测试环境，注意上线前需切换为正式环境运营。
2. 打开调试信息开关。调试开关开启后，SDK 会把网络请求、错误消息等输出到 IDE 的日志窗口，方便开发者调试。注意上线前关闭。

核心代码片段示例如下：

// 测试环境开关
AUDIOROOM::SetUseTestEnv(g_useTestEnv);

// 通过宏定义选择是否打开调试信息，仅供参考
#ifdef DEBUG

// 调试信息开关
AUDIOROOM::SetVerbose(true);

#endif

// 设置 UserID 和 UserName。
AUDIOROOM::SetUser(UserID, UserName);

// 设置回调对象指针
AUDIOROOM::SetAudioLivePublisherCallback(m_pAVSignal);
AUDIOROOM::SetAudioLivePlayerCallback(m_pAVSignal);
AUDIOROOM::SetAudioRoomCallback(m_pAVSignal);
AUDIOROOM::SetAudioIMCallback(m_pAVSignal);
AUDIOROOM::SetAudioDeviceStateCallback(m_pAVSignal);

//初始化SDK
AUDIOROOM::InitSDK(g_dwAppID2, g_bufSignKey2, 32);

2.3 完成 SDK 初始化

初始化完成后，开发者即可调用 SDK 相关接口，实现对应功能。

2.4 集成日志上传

ZEGO SDK 不会自动上传日志，为了便于人工定位问题，我们建议开发者将 ZEGO SDK 的日志上传功能，集成在 App 的合适位置。

请注意，建议开发者在 App 中引导用户手动触发日志上传。不建议 App 频繁自动上传日志。

ZEGO SDK 提供如下 API 上传日志：

LiveRoom.h

/**
 上报日志

 @discussion 上传日志到后台便于分析问题
 */
void UploadLog();

API 调用示例代码如下：

LIVEROOM::UploadLog();