tencent cloud

Tencent Real-Time Communication

소식 및 공지 사항
제품 업데이트
Tencent Cloud 오디오/비디오 단말 SDK 재생 업그레이드 및 권한 부여 인증 추가
TRTC 월간 구독 패키지 출시 관련 안내
제품 소개
제품 개요
기본 개념
제품 기능
제품 장점
응용 시나리오
성능 데이터
구매 가이드
Billing Overview
무료 시간 안내
Monthly subscription
Pay-as-you-go
TRTC Overdue and Suspension Policy
과금 FAQ
Refund Instructions
신규 사용자 가이드
Demo 체험
Call
개요(TUICallKit)
Activate the Service
Run Demo
빠른 통합(TUICallKit)
오프라인 푸시
Conversational Chat
온클라우드 녹화(TUICallKit)
AI Noise Reduction
UI 사용자 정의
Calls integration to Chat
Additional Features
No UI Integration
Server APIs
Client APIs
Solution
ErrorCode
릴리스 노트
FAQs
라이브 스트리밍
Billing of Video Live Component
Overview
Activating the Service (TUILiveKit)
Demo 실행
No UI Integration
UI Customization
Live Broadcast Monitoring
Video Live Streaming
Voice Chat Room
Advanced Features
Client APIs
Server APIs
Error Codes
Release Notes
FAQs
RTC Engine
Activate Service
SDK 다운로드
API 코드 예시
Usage Guidelines
API 클라이언트 API
고급 기능
RTC RESTFUL API
History
Introduction
API Category
Room Management APIs
Stream mixing and relay APIs
On-cloud recording APIs
Data Monitoring APIs
Pull stream Relay Related interface
Web Record APIs
AI Service APIs
Cloud Slicing APIs
Cloud Moderation APIs
Making API Requests
Call Quality Monitoring APIs
Usage Statistics APIs
Data Types
Appendix
Error Codes
콘솔 가이드
애플리케이션 관리
사용량 통계
모니터링 대시보드
개발 보조
Solution
Real-Time Chorus
FAQs
과금 개요
기능 관련
UserSig 관련
방화벽 제한 처리
설치 패키지 용량 축소 관련 질문
Andriod 및 iOS 관련
Web 관련
Flutter 관련
Electron 관련
TRTCCalling Web 관련
멀티미디어 품질 관련
기타 질문
Protocols and Policies
컴플라이언스 인증
보안 백서
정보 보안에 관한 참고 사항
Service Level Agreement
Apple Privacy Policy: PrivacyInfo.xcprivacy
TRTC 정책
개인 정보 보호 정책
데이터 처리 및 보안 계약
용어집
문서Tencent Real-Time CommunicationRTC EngineUsage Guidelines06. Advanced Guide시스템 오디오 공유Mac

Mac

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2024-07-24 15:00:17

시나리오의 문제점 및 솔루션

화면 공유 등 응용 시나리오에서는 시스템 오디오를 상대방에게 공유해야 하는 상황이 종종 발생하지만, Mac 컴퓨터는 기본적으로 사운드 카드에서 시스템 오디오 수집을 지원하지 않아 곤란할 때가 많습니다. 이에 따라 TRTC는 해당 시나리오에 대한 수요를 위해 Mac 시스템 오디오 녹음 기능을 제공합니다. 구체적인 액세스 방법은 다음과 같습니다.

통합 설명

1단계: TRTCPrivilegedTask 라이브러리 통합

SDK는 TRTCPrivilegedTask 라이브러리를 사용해 root 권한을 획득하므로, 버츄얼 사운드 카드 플러그 인 TRTCAudioPlugin.driver를 시스템 디렉터리 /Library/Audio/Plug-Ins/HAL에 설치합니다.
CocoaPods를 사용한 통합
수동 통합
1. 현재 프로젝트의 루트 디렉터리에서 Podfile 파일을 연 뒤 다음 내용을 추가합니다.
platform: osx, '10.10'  

target 'Your Target' do
    pod 'TRTCPrivilegedTask', :podspec => 'https://pod-1252463788.cos.ap-guangzhou.myqcloud.com/liteavsdkspec/TRTCPrivilegedTask.podspec'
end

2. pod install 명령어를 실행하여 TRTCPrivilegedTask 라이브러리를 설치합니다.
설명：
프로젝트의 루트 디렉터리에 `Podfile` 파일이 없는 경우, 먼저 `pod init` 명령어를 실행하여 파일을 생성한 뒤 다음 내용을 추가합니다.
CocoaPods 설치 방법은 CocoaPods 공식 홈페이지 설치 설명을 참고하십시오.
1. TRTCPrivilegedTask 라이브러리를 다운로드합니다.
2. Xcode 프로그래밍 프로젝트를 열어 압축 해제한 파일 libPrivilegedTask.a를 프로그램으로 가져옵니다.
3. 실행할 타깃을 선택하고 Build Phases를 선택합니다. Link Binary with Libraries를 펼치고 아래쪽에 있는 + 버튼을 클릭하여 종속 라이브러리 libPrivilegedTask.a를 추가합니다.
libPrivilegedTask.a



2단계: App Sandbox 기능 취소

App의 entitlements 설명 파일에서 App Sandbox 항목을 삭제합니다.
Sandbox



3단계: 버츄얼 사운드 카드 플러그 인 패키징

TRTCPrivilegedTask 라이브러리 통합 및 App Sandbox 기능 취소를 완료한 후, 처음 시스템 오디오 녹음 기능 사용 시 SDK는 네트워크에서 버츄얼 사운드 카드 플러그 인을 다운로드 및 설치합니다. 해당 과정을 신속하게 진행하고 싶은 경우, 다음 이미지와 같이 TXLiteAVSDK_TRTC_Mac.framework의 PlugIns 디렉터리에 있는 버츄얼 사운드 카드 플러그 인 TRTCAudioPlugin.driver을 App Bundle의 Resources 디렉터리에 패키징합니다.
플러그 인 패키징

또는 다음 이미지와 같이 App Bundle의 PlugIns 디렉터리로 복사합니다.
플러그 인 패키징2



4단계: 시스템 오디오 수집 시작

startSystemAudioLoopback 인터페이스를 호출하여 시스템 오디오 수집을 시작하고, 이를 오디오 업스트림에 혼합합니다. 인터페이스에서 실행이 완료되면 onSystemAudioLoopbackError를 통해 완료 또는 실패 결과를 콜백합니다.
TRTCCloud *trtcCloud = [TRTCCloud sharedInstance];
[trtcCloud startLocalAudio];
[trtcCloud startSystemAudioLoopback];
주의사항：
TRTCPrivilegedTask 라이브러리 통합 및 App Sandbox 기능 취소 후 처음 startSystemAudioLoopback 호출 시 다음 이미지와 같이 root 권한을 획득할 수 있습니다.예를 클릭하면 버츄얼 사운드 카드 플러그 인이 자동으로 설치됩니다.

5단계: 시스템 오디오 수집 중지

stopSystemAudioLoopback 인터페이스를 호출하여 시스템 사운드 수집을 중지합니다.
TRTCCloud *trtcCloud = [TRTCCloud sharedInstance];
[trtcCloud stopSystemAudioLoopback];

6단계: 시스템 사운드 수집 음량 설정

setSystemAudioLoopbackVolume 인터페이스를 호출하여 시스템 사운드 수집 음량을 설정합니다.
TRTCCloud *trtcCloud = [TRTCCloud sharedInstance];
[trtcCloud setSystemAudioLoopbackVolume:80];

결론

TRTC는 Mac에서 버츄얼 사운드 카드 플러그 인 TRTCAudioPlugin.driver를 통해 시스템 오디오를 녹음합니다. 이 버츄얼 사운드 카드 플러그 인은 시스템 디렉터리 /Library/Audio/Plug-Ins/HAL에 복사하여 오디오 서비스를 재시작하면 적용됩니다. 실행의 기타 폴더에 있는 오디오 MIDI 설정 애플리케이션으로 버츄얼 사운드 카드 플러그 인이 정상적으로 설치되었는지 확인할 수 있으며, 해당 애플리케이션의 디바이스 리스트에 'TRTC Audio Device'가 있으면 TRTC 버츄얼 사운드 카드 플러그 인이 정상적으로 설치된 것입니다.
TRTCPrivilegedTask 라이브러리 통합 및 App Sandbox 기능 취소는 TRTC SDK에 버츄얼 사운드 플러그 인 자동 설치를 위한 root 권한을 제공합니다. TRTCPrivilegedTask 라이브러리를 통합하지 않고 App Sandbox 기능을 유지하는 경우, SDK는 버츄얼 사운드 카드 플러그 인을 자동으로 설치하지 않습니다. 단, 시스템에 이미 버츄얼 사운드 카드 플러그 인이 설치되어 있는 경우 시스템 오디오 녹음 기능은 정상적으로 사용할 수 있습니다.
설명：
위 방법 외에도 수동으로 버츄얼 사운드 카드 플러그 인을 설치하여 해당 기능을 통합할 수 있습니다.
1. TXLiteAVSDK_TRTC_Mac.framework의 PlugIns 디렉터리에 있는 TRTCAudioPlugin.driver를 시스템 디렉터리 /Library/Audio/Plug-Ins/HAL로 복사합니다.
2. 시스템 오디오 서비스를 재시작합니다.
 sudo cp -R TXLiteAVSDK_TRTC_Mac.framework/PlugIns/TRTCAudioPlugin.driver /Library/Audio/Plug-Ins/HAL  
 sudo kill -9 `ps ax|grep 'coreaudio[a-z]' |awk '{print $1}'`


주의 사항

App Sandbox 기능을 취소하면 App에서 획득한 사용자 경로가 변경됩니다.NSSearchPathForDirectoriesInDomains 등 시스템 메소드를 통해 획득한 ~/Documents, ~/Library 등의 디렉터리는 샌드박스 디렉터리에서 사용자 디렉터리인 /Users/사용자 이름/Documents, /Users/사용자 이름/Library로 전환됩니다.
TRTCPrivilegedTask 라이브러리를 통합하면 Mac App Store에 App을 출시하지 못할 수도 있습니다.SDK에서 버츄얼 사운드 카드 플러그 인 자동 설치 시 App Sandbox 기능을 비활성화하고 root 권한을 획득해야 합니다. 이 경우 Mac App Store에 App을 출시하지 못할 수 있으며, 자세한 내용은 App Store Review Guidelines를 참조하십시오.App Store에 App을 출시해야 하거나 Sandbox 기능을 사용해야 할 경우 버츄얼 사운드 카드 플러그 인 수동 설치를 권장합니다.
이전 주제: Web다음 주제: Electron

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백