Skip to content

Latest commit

 

History

History
96 lines (66 loc) · 6.24 KB

README.zh.md

File metadata and controls

96 lines (66 loc) · 6.24 KB
Raw

API Example macOS

English | 中文

简介

该仓库包含了使用 RTC Objective-C SDK for macOS 的示例项目。

api-examples-macos

项目结构

此项目使用一个单独的 app 实现了多种功能。每个功能以 storyboard 的形式加载，方便你进行试用。

Function Location
自定义音频采集 CustomAudioSource.swift
自定义视频渲染 CustomVideoRender.swift
原始音视频数据 (Objective-C 混编 C++, 使用 AgoraMediaRawData.h ) RawMediaData.swift
原始音频数据 (Native Objective-C 接口) RawAudioData.swift
自定义视频采集 (Push) CustomVideoSourcePush.swift
自定义视频采集 (mediaIO) CustomVideoSourceMediaIO.swift
加入频道（音频） JoinChannelAudio.swift
加入频道（音视频） JoinChannelVideo.swift
混音与音频文件播放 AudioMixing.swift
变声与音效 VoiceChanger.swift
RTMP 推流 RTMPStreaming.swift
媒体流加密（自定义加密 + SDK 加密） StreamEncryption.swift
呼叫前测试 PrecallTest.swift
多进程同时发送屏幕共享流和摄像头采集流 ScreenShare.swift
发送数据流 CreateDataStream.swift

如何运行示例项目

前提条件

  • XCode 10.0 +
  • Mac 设备。macOS 版本为 10.0 +

运行步骤

  1. 切换到 macOS 目录，运行以下命令使用 CocoaPods 安装依赖，Agora 视频 SDK 会在安装后自动完成集成。

    $ pod install

  2. 使用 Xcode 打开生成的 APIExample.xcworkspace。

  3. 编辑 KeyCenter.swift 文件。

    • 将 YOUR APP ID 替换为你的 App ID。
    • 将 <#Temp Access Token#> 替换为你的 Access Token。
    struct KeyCenter {
static let AppId: String = <#Your App Id#>

// assign token to nil if you have not enabled app certificate
static var Token: String? = <#Temp Access Token#>
}

    参考 校验用户权限 了解如何获取 App ID 和 Token。你可以获取一个临时 token，快速运行示例项目。

    生成 Token 使用的频道名必须和加入频道时使用的频道名一致。

    为提高项目的安全性，Agora 使用 Token（动态密钥）对即将加入频道的用户进行鉴权。

    临时 Token 仅作为演示和测试用途。在生产环境中，你需要自行部署服务器签发 Token，详见生成 Token。

  4. 构建并在 Mac 设备中运行项目。

一切就绪。你可以自由探索示例项目，体验 RTC Objective-C for macOS SDK 的丰富功能。

反馈

如果你有任何问题或建议，可以通过 issue 的形式反馈。

参考文档

相关资源

  • 你可以先参阅 常见问题
  • 如果你想了解更多官方示例，可以参考 官方 SDK 示例
  • 如果你想了解声网 SDK 在复杂场景下的应用，可以参考 官方场景案例
  • 如果你想了解声网的一些社区开发者维护的项目，可以查看 社区
  • 若遇到问题需要开发者帮助，你可以到 开发者社区 提问
  • 如果需要售后技术支持, 你可以在 Agora Dashboard 提交工单

代码许可

示例项目遵守 MIT 许可证。