IAgoraService 类
- C++
更新时间不可用
createAgoraService
AGORA_API agora::base::IAgoraService* AGORA_CALL createAgoraService();创建一个 IAgoraService 对象并返回指针。
返回值
- 方法调用成功，返回
IAgoraService对象指针。 - 方法调用失败，返回空指针。
initialize
virtual int initialize(const AgoraServiceConfiguration& config) = 0;初始化 IAgoraService 对象。
参数
| 参数 | 数据类型 | 描述 |
|---|---|---|
config | const AgoraServiceConfiguration& | 初始化配置。详见 AgoraServiceConfiguration。 |
返回值
- 0：方法调用成功。
- < 0：方法调用失败。
release
virtual int release() = 0;释放 IAgoraService 对象。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。
setLogFile
virtual int setLogFile(const char* filePath, unsigned int fileSize, aosl_ref_t ares = AOSL_REF_INVALID) = 0;设置 SDK 日志文件的路径和大小。
SDK 运行期间会将所有日志数据记录在两个日志文件中，每个文件的默认大小为 512 KB。如果将 fileSize 设置为 1024 KB，日志文件的总大小为 2 MB。当日志文件总大小超过设置值时，新日志将覆盖旧日志。
注意
为确保日志输出完整，请在调用 initialize 后立即调用此方法。
参数
| 参数 | 数据类型 | 描述 |
|---|---|---|
filePath | const char* | 日志文件路径指针。请确保该路径所在目录存在且可写。 |
fileSize | unsigned int | 每个日志文件的大小（字节）。 |
返回值
- 0：方法调用成功。
- < 0：方法调用失败。
setLogFilter
virtual int setLogFilter(unsigned int filters, aosl_ref_t ares = AOSL_REF_INVALID) = 0;设置 SDK 日志输出过滤器。
日志级别的顺序为 OFF、CRITICAL、ERROR、WARNING、INFO 和 DEBUG。
你可以选择一个日志级别，SDK 会输出该级别及以上级别的日志。例如，如果将日志级别设置为 WARNING，则会输出 CRITICAL、ERROR 和 WARNING 级别的日志。
参数
| 参数 | 数据类型 | 描述 |
|---|---|---|
filters | unsigned int | 日志输出过滤器。
|
返回值
- 0：方法调用成功。
- < 0：方法调用失败。
getAgoraParameter
virtual agora_refptr<base::IAgoraParameter> getAgoraParameter() = 0;获取 IAgoraParameter 对象。
返回值
- 方法调用成功，返回
IAgoraParameter对象。 - 方法调用失败，返回空指针。