Skip to content

오디오 ​

tapflow는 영상과 함께 기기 오디오를 브라우저로 전송합니다. 덕분에 팀 전체가 앱을 눈으로 보는 데 그치지 않고 소리까지 함께 확인할 수 있습니다. 앱 사운드, 웹 오디오(예: 인앱 브라우저에서 재생하는 영상), 시스템 사운드가 모두 전달됩니다.

기본 켜짐 ​

오디오는 iOS와 Android 양쪽에서 기본으로 켜져 있습니다. 뷰어가 브라우저에서 기기를 열면 해당 탭에서 오디오가 재생됩니다.

에이전트별로 환경 변수로 끌 수 있습니다.

bash
TAPFLOW_AUDIO=off tapflow agent start

이 설정은 양쪽 플랫폼의 오디오 캡처를 끕니다. 영상 경로는 어느 쪽이든 그대로 유지됩니다.

요구 사항 ​

  • iOS: 에이전트 Mac이 macOS 14.2 이상이어야 합니다(Core Audio 프로세스 탭). iOS 에이전트는 macOS 26 이상에서 동작하므로(시스템 요구사항) 지원 환경에서는 이 조건이 항상 충족됩니다.
  • Android: 에뮬레이터 스트림으로 캡처하므로 추가 요구 사항이 없습니다.

권한 (최초 1회) ​

iOS 오디오 캡처와 아래의 Android 호스트 음소거는 macOS 오디오 녹음 권한을 사용합니다. 그래서 처음 필요한 순간에 macOS가 1회성 권한 창을 띄웁니다.

tapflow agent start(그리고 tapflow setup ios)가 이 권한을 미리 요청합니다. 무인 운영자가 첫 부팅 때 놓치지 않고 그 자리에서 승인하도록 하기 위함입니다. 브라우저에서 소리가 나지 않으면 tapflow agent start를 다시 실행하세요. 권한 창이 다시 뜹니다.

TIP

이 권한은 대시보드 뷰어가 아니라 Mac을 운영하는 에이전트 운영자가 승인합니다.

에이전트 Mac은 조용합니다 ​

오디오가 켜져 있어도 기기 소리는 브라우저에서만 재생됩니다. 에이전트 Mac의 스피커는 조용하게 유지되므로 공용이거나 무인으로 두는 Mac에서도 소리가 새거나 울리지 않습니다.

  • iOS: 캡처 단계에서 오디오를 음소거합니다.
  • Android (macOS 14.2 이상): 음소거 전용 탭이 에뮬레이터의 호스트 출력을 차단합니다. macOS 14.2 미만에서는 에뮬레이터 소리가 에이전트 Mac에서 들리므로 Mac 볼륨을 낮추세요.

에이전트 Mac의 다른 앱은 영향을 받지 않습니다.

볼륨 ​

기기 자체 볼륨이 브라우저로 전달되는 소리에 반영됩니다. 시뮬레이터나 에뮬레이터 볼륨을 바꾸면 전송되는 오디오도 따라 바뀝니다.

문제 해결 ​

브라우저에서 소리가 나지 않을 때

  • tapflow agent start를 다시 실행해 권한 창을 띄우고 허용을 누르세요.
  • iOS: 에이전트 Mac이 macOS 14.2 이상인지 확인하세요.
  • TAPFLOW_AUDIO가 off로 설정되어 있지 않은지 확인하세요.

에이전트 Mac에서 에뮬레이터 소리가 날 때 (Android)

  • macOS 14.2 미만에서는 정상입니다. Mac 볼륨을 낮추세요. macOS 14.2 이상에서는 자동으로 음소거됩니다.

함께 보기: 스트리밍 품질

Released under the MIT License.