iOS에서 Agora SDK 통합

Mar 16 2023

동영상, 채팅 등을 위한 실시간 애플리케이션을 Agora의 글로벌 네트워크와 동기화하세요.

이 자습서에서는 그룹의 사람들이 화상 통화 및 채팅을 통해 연결할 수 있는 실시간 애플리케이션을 만드는 방법을 배웁니다. 아이디어는 Agora RTM을 통한 실시간 메시징이 소규모 브레이크아웃 채널을 통해 사용자를 연결하는 오케스트레이션 레이어로 사용되는 방법을 보여주는 것입니다. 여기에서 사용자는 Agora Real-time Communication 엔진을 사용하여 기존 화상 통화를 만들거나 참여할 수 있습니다.

앱 흐름

앱 흐름은 다음과 같습니다.

"가입" 버튼을 탭하세요
다음으로 여러 사용자가 채널에서 동영상을 방송하는 것을 볼 수 있습니다.
이제 방송인이 되려면 화면 상단의 "호스트"를 누릅니다.
이 시점에서 카메라 및 마이크 권한이 나타납니다.
플립 카메라(전면/후면 카메라 간)
카메라 켜기/끄기 전환
마이크 켜기/끄기 전환
미화 필터를 전환하면 이미지가 더 부드러워지고 방송인의 목소리도 더 선명해집니다.

비디오 SDK
오디오 SDK

아고라 사진

아고라 개발자 계정
엑스코드 11.0 이상
13.0 이상이 설치된 iOS 장치
iOS 개발에 대한 기본적인 이해
코코아팟

설정

Xcode에서 iOS 또는 macOS 프로젝트 생성을 클릭하여 시작합니다.

Xcode에 Agora SDK와 같은 대용량 라이브러리를 다운로드하는 데 문제가 있습니다. 오류가 표시되면 다음과 같이 swift 패키지를 추가할 수 있습니다. Xcode에서 File > Swift Packages > Reset Package Caches 를 선택합니다 .

코코아팟

CocoaPod를 설치하려면 최신 릴리스 버전과 함께 Pod 파일 AgoraUIKit_iOS 에 작성하고 Podfile은 다음과 같아야 합니다.

target 'Agora-UIKit-Project' do
  pod 'AgoraUIKit_iOS', '~> 4.0.3'
end

를 실행 pod install하고 .xcworkspace 파일을 열어 시작합니다.

카메라와 마이크를 사용하려면 앱에 대한 권한을 추가하십시오. 이를 위해 Xcode 프로젝트의 루트에서 Info.plist 파일을 연 다음 NSMicrophoneUsageDescription 과 함께 NSCameraUsageDescription 을 추가합니다 .

미디어 캡처 승인 요청에 대한 자세한 내용은 Apple의 이 문서를 확인하십시오 .

어떻게 되는지 보자 :

비디오 스트리밍 추가

AgoraViewController를 원하는 경우 컨트롤러에 아래 피드를 로드하기만 하면 전체 ViewController가 다음과 같이 표시됩니다.

왼쪽의 그리드 레이아웃, 오른쪽의 플로팅 레이아웃

아고라 사진

기본적인 방법으로 Agora UIKit을 사용할 때 필요한 모든 것입니다. 그러나 이것은 토큰을 고려하지 않으며 보안을 위해 프로덕션 앱에서도 토큰이 필요합니다.

토큰 통합

토큰을 이해하기 위해 여러 블로그와 리포지토리를 사용할 수 있습니다. 2-Click 설정 가이드 , Golang의 사전 구축된 토큰 서버 , Swift 앱으로 토큰 가져오기 에 대한 정보를 포함합니다 .

AgoraSettings 개체를 정의해야 합니다. 그런 다음 토큰 URL에 값을 할당한 다음 AgoraVideoViewer 개체를 만드는 동안 설정 개체를 적용합니다.

이제 새 채널에 연결할 때마다 부울 값을 요청 fetchToken하고 이를 true로 설정합니다.

요약

화상 통화 및 실시간 채팅을 위해 Agora의 네트워크를 사용하여 프로덕션 애플리케이션을 만드는 것이 이제 그 어느 때보다 쉬워졌습니다. 동일한 클래스와 메서드가 macOS 응용 프로그램에서도 작동합니다.

Advanced Agora UIKit 블로그 로 이동하면 iOS 및 macOS용 Agora UIKit의 잠재력을 최대한 활용할 수 있습니다. 이 라이브러리를 사용하여 더 많은 사용자 정의 및 개선 사항을 만들 수 있습니다.

아고라 사진

기타 리소스

Agora.io SDK를 사용하여 애플리케이션을 만드는 방법에 대한 자세한 내용은 Agora 화상 통화 빠른 시작 가이드를 확인하세요 .