# Zoom Meeting SDK for macOS (vendored)

Per [Zoom’s documentation](https://developers.zoom.us/docs/meeting-sdk/macos/get-started/), the Meeting SDK for macOS **does not run in the App Sandbox**. This project has sandboxing disabled when you use the embedded SDK path.

## Download

1. Sign in to the [Zoom App Marketplace](https://marketplace.zoom.us/).
2. Create or open a **General** app → **Embed** → enable **Meeting SDK**.
3. Download the **macOS** package.
4. From the unzipped `SampleApp/ZoomSDK` folder, copy into **this directory** (`Vendor/ZoomSDK/`):

   - `ZoomSDK.framework`
   - `libcrypto.dylib`, `libjson.dylib`, `libminizip.dylib`, `Libssl.dylib`, `libcares.dylib`, `libzoombase_crypto_shared.dylib` (names must match Zoom’s package; casing may vary—mirror the sample app’s **Link Binary With Libraries** list).

5. From the package **Plugin** (or `Plugins`) folder, add **`ZoomAudioDevice.driver`** via Xcode **Build Phases → Copy Files** (Destination: **PlugIns**), as described in Zoom’s [integrate](https://developers.zoom.us/docs/meeting-sdk/macos/integrate/) guide.

## Link the framework

1. Open `Config/Base.xcconfig`.
2. Set:

   `ZOOM_SDK_LDFLAGS = -framework ZoomSDK`

3. In Xcode: **General → Frameworks, Libraries, and Embedded Content** — add `ZoomSDK.framework` with **Embed & Sign** if not already picked up from search paths (match Zoom’s sample).

4. **Other Linker Flags**: the xcconfig already adds `-ObjC`.

## Credentials

- **Meeting SDK JWT** is generated locally from the same **OAuth Client ID and Client Secret** you already use for Zoom sign-in (`ZoomOAuthClientId` / `ZOOM_OAUTH_CLIENT_SECRET`). Your Marketplace app must have **Meeting SDK** enabled for that client.
- **ZAK** (recommended for joining as the signed-in user) uses the in-app OAuth token; add Zoom’s **`user_zak:read`** (and/or legacy `user:read`) scope to your app so `GET /users/me/token?type=zak` succeeds.

## External meetings

Joining meetings **outside** the developer account may require Zoom app review and **ZAK** / **OBF** per [Zoom’s policy](https://developers.zoom.us/docs/meeting-sdk/macos/get-started/). If join fails, the app falls back to opening the link in the default browser.