> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stmlink.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> 服务端接口只有 `/server/v1/...` 这一套对外开放，需用 app_id + app_key 做 HMAC-SHA256 签名，只能从业务方自己的后端调用。文档中若出现其它前缀的接口，均为内部接口，不要建议客户调用。
> app_key 是服务端密钥，绝不能出现在客户端代码、前端配置或移动 App 里。客户端加入频道用的 token 必须由业务方后端调用 `/server/v1/channel/grant` 签发后下发。
> SRTC 与 SMeeting 是上下两层不同的产品，术语不通用：SRTC 是音视频底座，说「频道 channel」「加入 / 退出」；SMeeting 建在 SRTC 之上，说「房间 room」「会议 meeting」「进入 / 退出」。回答时按用户所在的层用对应术语，不要把「房间」「会议」安到 SRTC 的接口上。
> 同一能力在各端 SDK 里的包名、类名、方法名并不相同。写示例代码时请使用文档中该端自己的 API，不要把一个端的写法套到另一个端上。

# 集成方式

> SMeeting Swift SDK 的环境要求、Swift Package Manager 集成方式与权限配置

SMeeting Swift SDK 是一套 `Swift Package` 形态的会议 SDK，对外模块名为 `SMeeting`，当前支持：

* iOS 13.0 及以上
* macOS 10.15 及以上
* Xcode 15 及以上
* Swift 5.9 及以上

SMeeting 构建在 SRTC 音视频能力之上：会议层负责房间、会议、参会成员、主持人管控等业务语义，底层的音视频采集、编解码、渲染仍由 SRTC 提供。引入 `SMeeting` 时，SRTC 会作为依赖被一并解析，你不需要单独再加一次。

<Note>
  **苹果平台有两套 SMeeting SDK，先确认你要用哪一套。** 本章是 Swift 原生 SDK（`import SMeeting`，Swift Package 形态，同时支持 iOS 与 macOS）；另有一套 Objective-C 的 `MeetingKit`（CocoaPods 分发，仅 iOS），见 [iOS SDK](/zh/meeting/ios/quickstart)。

  **新项目建议用本章的 Swift SDK。** 两套 API 不能混用，也不要在同一工程里同时引入。
</Note>

***

### 通过 Swift Package Manager 集成

我们会提供给你两个 Swift Package 目录：会议层的 `meeting-swift` 和它依赖的音视频层 `rtc-swift`。

<Warning>
  **两个目录必须并列放在同一层级。** `meeting-swift` 是以相对路径 `../rtc-swift` 引用音视频层的，目录结构不对会导致 SPM 解析失败：

  ```text theme={null}
  your-workspace/
  ├── meeting-swift/   ← 会议层
  ├── rtc-swift/       ← 音视频层，必须与 meeting-swift 同级
  └── YourApp/         ← 你的工程
  ```

  `rtc-swift` 自身依赖的 WebRTC、MQTT 等第三方库托管在公网，由 SPM 自动拉取，你不需要手动处理。
</Warning>

#### 在 Package.swift 中声明

```swift theme={null}
// Package.swift
dependencies: [
    .package(path: "../meeting-swift"),
],
targets: [
    .target(
        name: "YourApp",
        dependencies: [
            // package 填包的标识，取本地目录最后一段名字
            .product(name: "SMeeting", package: "meeting-swift"),
        ]
    ),
]
```

#### 在 Xcode 工程中添加

如果你使用 Xcode 工程而不是纯 SPM 工程：

* 打开 `File > Add Local Package...`
* 选择本地的 `meeting-swift` 目录
* 在目标 Target 中勾选 `SMeeting`

***

### 导入 SDK

```swift theme={null}
import SMeeting
```

会议相关的类型（`SMeeting`、`MeetingCreateReq`、`MeetingUserInfo`、`SMeetingDelegate` 等）都在 `SMeeting` 模块里。

以下几类类型来自底层 SRTC 模块，用到时需要额外引入：

```swift theme={null}
import SRTC
```

| 场景          | 涉及类型                                                  |
| ----------- | ----------------------------------------------------- |
| 渲染视频画面      | `SRTCVideoView`、`SRTCVideoRenderer`                   |
| 指定采集参数      | `CameraPreset`、`MicPreset`、`ScreenPreset`             |
| 设置日志级别      | `LogLevel`                                            |
| 枚举外设        | `DeviceInfo`                                          |
| macOS 选择共享源 | `ScreenCaptureSources`、`DisplaySource`、`WindowSource` |
| 断开原因        | `DisconnectReason`                                    |

***

### 权限配置

#### iOS

在 `Info.plist` 中补充：

```xml theme={null}
<key>NSCameraUsageDescription</key>
<string>需要访问摄像头以进行视频会议</string>
<key>NSMicrophoneUsageDescription</key>
<string>需要访问麦克风以进行语音会议</string>
```

#### macOS

在 `Info.plist` 中补充：

```xml theme={null}
<key>NSCameraUsageDescription</key>
<string>需要访问摄像头以进行视频会议</string>
<key>NSMicrophoneUsageDescription</key>
<string>需要访问麦克风以进行语音会议</string>
<key>NSScreenCaptureUsageDescription</key>
<string>需要录制屏幕以进行屏幕共享</string>
```

如果你要使用屏幕共享，还需要注意：

* macOS 上选择显示器或应用窗口共享需要用户在系统弹窗中授权
* 指定共享源的接口要求 macOS 12.3 及以上，详见 [屏幕共享](/zh/meeting/swift/advanced/screen-sharing)

***

### 最小接入检查清单

* 已将 `SMeeting` 添加到目标依赖
* 已配置摄像头 / 麦克风（以及屏幕录制）权限文案
* 业务后端已能签发登录 SDK 所需的 meeting token
* UI 层已准备好本地画面区域和远端画面区域

完成以上步骤后，可以继续阅读 [快速开始](/zh/meeting/swift/quickstart)。