# 初始化相关 (/zh-CN/api-reference/rtc/macos/initialize)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## sharedEngineWithAppId\:delegate: [#sharedenginewithappiddelegate]
创建并初始化 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 实例。
```objc
+ (instancetype _Nonnull)sharedEngineWithAppId:(NSString * _Nonnull)appId
delegate:(id _Nullable)delegate NS_SWIFT_NAME(sharedEngine(withAppId:delegate:));
```
你可以使用该方法创建并初始化 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 实例。该类中所有方法均为异步执行,建议你在同一线程中调用这些方法。
:::note
注:
- 在调用其他 API 之前,必须先调用该方法创建 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 对象。
- 你可以通过该方法或 [sharedEngineWithConfig\:delegate:](/zh-CN/api-reference/rtc/macos/initialize#api_irtcengine_initialize) 方法创建 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 实例。与该方法相比,[sharedEngineWithConfig\:delegate:](/zh-CN/api-reference/rtc/macos/initialize#api_irtcengine_initialize) 支持更多配置,例如指定连接区域和设置日志文件。
- 每个 App 仅支持创建一个 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 实例。
:::
### 参数 [#参数]
声网为你的项目签发的 App ID。只有使用相同 App ID 的用户才能加入同一个频道并进行通信。一个 App ID 只能用于创建一个 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 实例。若需更换 App ID,你需要先调用 [destroy](/zh-CN/api-reference/rtc/macos/initialize#api_irtcengine_release) 方法销毁当前实例,然后再创建新的实例。
[AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 的事件回调处理器。详见 [AgoraRtcEngineDelegate](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengineeventhandler)。
### 返回值 [#返回值]
- 方法调用成功,返回 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 对象。
- 方法调用失败,返回一个其内部引擎字段为 nil 的 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 对象。你可以通过 [delegate](/zh-CN/api-reference/rtc/macos/channel#api_irtcengine_delegate) 的 [rtcEngine\:didOccurError:](/zh-CN/api-reference/rtc/macos/channel#callback_irtcengineeventhandler_onerror) 回调获取错误码。
### 所属接口类 [#所属接口类]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)
## destroy: [#destroy]
销毁 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 实例并释放相关资源。
```objc
+ (void)destroy:(void (^ _Nullable)(void))engineReleasedBlock NS_SWIFT_NAME(destroy(_:));
```
:::info[自从]
自 v4.6.0 版本新增。
:::
当你不再需要实时通信时,调用此方法以释放 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 实例及其相关资源,使这些资源可用于其他操作。推荐在语音或视频通话场景中使用。
### 参数 [#参数-1]
当 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 实例被销毁时触发的回调,用于配置同步或异步销毁:
- 非 nil:异步销毁。方法会立即返回,但引擎资源可能尚未完全释放。引擎销毁后会触发 `engineReleasedBlock` 回调。
- nil:同步销毁。方法仅在引擎资源完全释放后才返回。
### 所属接口类 [#所属接口类-1]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)
## sharedEngineWithConfig\:delegate: [#sharedenginewithconfigdelegate]
创建并初始化 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 实例。
```objc
+ (instancetype _Nonnull)sharedEngineWithConfig:(AgoraRtcEngineConfig * _Nonnull)config
delegate:(id _Nullable)delegate NS_SWIFT_NAME(sharedEngine(with:delegate:));
```
你可以通过调用此方法或调用 [sharedEngineWithAppId\:delegate:](/zh-CN/api-reference/rtc/macos/initialize#api_irtcengine_create) 来创建 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 实例。与 [sharedEngineWithAppId\:delegate:](/zh-CN/api-reference/rtc/macos/initialize#api_irtcengine_create) 不同,此方法在创建 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 实例时支持更多配置,例如指定连接区域和设置日志文件。
:::note
注: [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 每个 App 仅支持创建一个实例。[AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 提供的所有方法均为异步执行。声网建议你在同一线程中调用这些方法。
:::
### 调用时机 [#调用时机]
在调用其他 API 之前,必须先调用此方法创建 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 对象。
### 参数 [#参数-2]
用于配置 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 实例的参数。详见 [AgoraRtcEngineConfig](/zh-CN/api-reference/rtc/macos/class-rtcengineconfig)。
[AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 的事件回调处理器。详见 [AgoraRtcEngineDelegate](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengineeventhandler)。
### 返回值 [#返回值-1]
- 方法调用成功时,返回初始化后的 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 对象。
- 方法调用失败时,返回一个其内部引擎字段为 nil 的 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 对象。你可以通过 [delegate](/zh-CN/api-reference/rtc/macos/channel#api_irtcengine_delegate) 的 [rtcEngine\:didOccurError:](/zh-CN/api-reference/rtc/macos/channel#callback_irtcengineeventhandler_onerror) 回调获取错误码。
### 所属接口类 [#所属接口类-2]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)
## destroy [#destroy-1]
释放 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 实例。
```objc
+ (void)destroy NS_SWIFT_NAME(destroy());
```
该方法会释放 SDK 使用的所有资源。适用于用户偶尔进行语音或视频通话的场景。当你不再进行通话时,可以通过该方法释放资源,以便用于其他操作。成功调用该方法后,将无法再使用 SDK 中的任何方法或回调。如需再次使用实时通信功能,必须调用 [sharedEngineWithConfig\:delegate:](/zh-CN/api-reference/rtc/macos/initialize#api_irtcengine_initialize) 方法重新创建 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 实例。
:::note
注: 声网不建议你在 SDK 的任何回调中调用 [destroy](/zh-CN/api-reference/rtc/macos/initialize#api_irtcengine_release) 方法。否则,SDK 需等待回调返回结果后才能释放资源,可能导致死锁。
:::
### 所属接口类 [#所属接口类-3]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)