> ## Documentation Index
> Fetch the complete documentation index at: https://manual.voiceping.net/llms.txt
> Use this file to discover all available pages before exploring further.

# 기기·권한·네트워크 상태 확인

> VoicePing 액세스 진단을 실행하고 권한, 네트워크, LiveKit 결과를 확인한 뒤 지원용 보고서를 내보내는 방법

export const FeedbackKo = () => <>
    <Tip>
      기능 개선 의견이나 요청은 <a href="/ko/product-feedback">Product Feedback</a>에서 보내 주세요.
    </Tip>

    <h2>공식 링크</h2>

    <CardGroup cols={2}>
      <Card title="공식 웹사이트" icon="globe" href="https://voiceping.net/en/">
        VoicePing 공식 웹사이트 열기
      </Card>
      <Card title="X (Twitter)" icon="x-twitter" href="https://x.com/VoicePingMedia">
        X에서 VoicePing 팔로우하기
      </Card>
      <Card title="Facebook" icon="facebook" href="https://www.facebook.com/voiceping.inc">
        Facebook 페이지 열기
      </Card>
      <Card title="LinkedIn" icon="linkedin" href="https://www.linkedin.com/company/28684130/">
        LinkedIn 페이지 열기
      </Card>
    </CardGroup>
  </>;

마이크·카메라·화면 공유·데스크톱 오디오·가상 오피스가 정상적으로 작동하지 않거나 VoicePing에 연결되지 않으면 <strong>액세스 진단(Access Diagnostics)</strong>을 실행하세요. 현재 컴퓨터의 기기, 운영체제 권한, 네트워크 연결을 한 번에 확인할 수 있습니다.

<Note>
  액세스 진단은 현재 컴퓨터와 연결된 네트워크를 검사합니다. 기기, macOS 또는 Windows 권한, VPN, 프록시, 방화벽이나 네트워크를 변경한 뒤에는 다시 실행하세요.
</Note>

## 액세스 진단 실행하기

1. VoicePing 데스크톱 앱을 엽니다.
2. 왼쪽 사이드바 아래의 <strong>Settings(설정)</strong>를 선택합니다.
3. <strong>My Settings</strong>에서 <strong>Access Diagnostics(액세스 진단)</strong>를 선택합니다.
4. <strong>Run diagnostics</strong>를 선택해 24개 항목을 모두 진단합니다.

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/1M3CZt2RnsMlBuaa/ko/images/access-diagnostics/01-overview.webp?fit=max&auto=format&n=1M3CZt2RnsMlBuaa&q=85&s=54959f2f3a92f856f5221e32381dece3" alt="VoicePing 전체에서 설정과 액세스 진단의 위치 및 전체 진단 화면을 6개의 번호로 보여 주는 개요" width="2620" height="1920" data-path="ko/images/access-diagnostics/01-overview.webp" />
</Frame>

먼저 개요에서 액세스 진단의 위치와 전체 화면을 살펴보세요. 각 조작 위치는 아래 확대 화면을 참고하세요.

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/1M3CZt2RnsMlBuaa/ko/images/access-diagnostics/02-open-and-run-details.webp?fit=max&auto=format&n=1M3CZt2RnsMlBuaa&q=85&s=0abd2156fd33323f7deb7e13e96fadab" alt="설정, 액세스 진단, 24개 항목 전체 진단, 요약, 개별 검사, 보고서 내보내기를 확대해서 설명하는 한국어 번호 주석" width="1750" height="2300" data-path="ko/images/access-diagnostics/02-open-and-run-details.webp" />
</Frame>

기기, 권한, 접속 대상 또는 LiveKit(가상 오피스) 연결 중 한 항목만 다시 확인하려면 해당 항목 옆의 <strong>Check</strong>를 선택하세요.

## 진단 결과 확인하기

진단이 진행되면 화면 상단의 상태별 건수가 갱신됩니다.

| 상태                                    | 의미                                         | 조치                                |
| ------------------------------------- | ------------------------------------------ | --------------------------------- |
| <strong>Passed or reachable</strong>  | VoicePing이 권한, 기기 또는 네트워크 대상에 접근할 수 있습니다.  | 별도의 조치가 필요하지 않습니다.                |
| <strong>Warnings or failures</strong> | 권한이 차단되었거나, 기기를 사용할 수 없거나, 대상에 연결할 수 없습니다. | 해당 결과를 열고 표시된 안내를 따르세요.           |
| <strong>Ready or checking</strong>    | 검사가 아직 시작되지 않았거나 진행 중입니다.                  | 완료될 때까지 기다리거나 해당 항목을 개별적으로 실행하세요. |

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/1M3CZt2RnsMlBuaa/ko/images/access-diagnostics/03-review-results.webp?fit=max&auto=format&n=1M3CZt2RnsMlBuaa&q=85&s=5ed77d00f8f976942bb54d637128e2fb" alt="통과 21개, 권한 경고 2개, 미완료 1개, 결과와 관계없이 가능한 내보내기, 권한 세부 정보를 설명하는 한국어 번호 주석" width="900" height="1240" data-path="ko/images/access-diagnostics/03-review-results.webp" />
</Frame>

<Note>
  이미지는 macOS 권한 경고가 2건 있고 웹캠 검사가 완료되지 않은 예입니다. 실제 개수와 기기 이름은 환경에 따라 다릅니다.
</Note>

## 기기, 권한 및 API 검사

네트워크 대상과 함께 다음 기기 및 권한 항목도 검사합니다.

| 검사                                      | 확인 내용                                          |
| --------------------------------------- | ---------------------------------------------- |
| <strong>Microphone</strong>             | 오디오 입력 기기에 접근할 수 있는지 확인합니다.                    |
| <strong>Webcam</strong>                 | 비디오 입력 기기에 접근할 수 있는지 확인합니다.                    |
| <strong>Audio speaker</strong>          | 재생에 사용할 오디오 출력 기기가 있는지 확인합니다.                  |
| <strong>Screen recording</strong>       | 화면 공유 및 화면 정보 확인에 필요한 화면 기록 권한을 확인합니다.         |
| <strong>Accessibility</strong>          | 가상 오피스 제어와 마우스·키보드 활동 추적에 필요한 권한을 확인합니다.       |
| <strong>Screen audio recording</strong> | 번역에 필요한 데스크톱·시스템 오디오를 캡처할 수 있는지 확인합니다.         |
| <strong>Main API access</strong>        | 현재 네트워크에서 VoicePing API 상태 엔드포인트가 응답하는지 확인합니다. |

권한 항목에 경고 또는 실패가 표시되면 <strong>Open settings</strong>를 선택하고 운영체제 설정에서 VoicePing을 허용한 다음, VoicePing으로 돌아와 <strong>Check</strong>를 다시 선택합니다.

### macOS 권한

<strong>시스템 설정 → 개인정보 보호 및 보안</strong>을 열고 해당 항목에서 VoicePing을 허용합니다.

* <strong>마이크</strong>
* <strong>카메라</strong>
* <strong>화면 및 시스템 오디오 기록</strong>
* <strong>손쉬운 사용</strong>

<Warning>
  화면 기록 또는 손쉬운 사용 권한을 변경한 뒤에는 결과를 갱신하기 위해 VoicePing을 종료하고 다시 열어야 할 수 있습니다.
</Warning>

Windows에서는 실패한 항목 옆의 <strong>Open settings</strong>를 선택하고 해당 Windows 개인정보 또는 보안 설정에서 VoicePing을 허용합니다.

## 네트워크 허용 목록 검사

<strong>Network allowlist</strong>에서는 VoicePing 핵심 앱, 실시간 번역, 가상 오피스, 정적 리소스 및 인증에 필요한 대상을 검사합니다. 각 결과에는 대상, 프로토콜, 응답 시간이 표시됩니다.

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/1M3CZt2RnsMlBuaa/ko/images/access-diagnostics/04-network-allowlist.webp?fit=max&auto=format&n=1M3CZt2RnsMlBuaa&q=85&s=a04a65e5216baf3df8e38d86924616b5" alt="Network allowlist의 접속 대상, 연결 상태, 응답 시간 및 개별 재검사 위치" width="900" height="730" data-path="ko/images/access-diagnostics/04-network-allowlist.webp" />
</Frame>

이미지는 첫 번째 접속 대상 카테고리를 보여 줍니다. 액세스 진단을 계속 스크롤하여 <strong>Live translation</strong>, <strong>Virtual office</strong>, <strong>Assets</strong>, <strong>Authentication</strong>도 확인하세요.

대상에 연결할 수 없는 경우 다음을 확인하세요.

1. 조직 정책에서 허용하는 경우 VPN 또는 프록시를 잠시 해제합니다.
2. 다른 네트워크에서 시도해 현재 네트워크가 VoicePing을 차단하는지 확인합니다.
3. IT 관리자에게 [네트워크 통신 프로토콜(방화벽)](/ko/network-firewall)을 검토하도록 요청합니다.
4. 네트워크 규칙을 수정한 뒤 해당 대상을 다시 검사합니다.

## LiveKit(가상 오피스)

<strong>LiveKit media connectivity</strong>는 가상 오피스의 영상·음성 전송 상태만 확인합니다. VoicePing의 다른 기능은 이 결과로 판단할 수 없습니다. 짧은 진단 세션을 만들어 다음 하위 검사를 실행합니다.

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/1M3CZt2RnsMlBuaa/ko/images/access-diagnostics/05-livekit-results.webp?fit=max&auto=format&n=1M3CZt2RnsMlBuaa&q=85&s=0484ab766a58953fb242f05a641bcce1" alt="LiveKit 가상 오피스 연결 결과, 5개 하위 검사 및 UDP·RTT·비트레이트·전송 패킷 정보" width="900" height="760" data-path="ko/images/access-diagnostics/05-livekit-results.webp" />
</Frame>

<Note>
  이미지는 VoicePing STG에서 진단을 실행한 예입니다. 접속 대상, 응답 시간, 후보 유형 및 지표는 환경에 따라 달라집니다. 내부 테스트 주소와 진단 룸 정보는 매뉴얼에서 숨겼습니다.
</Note>

| 하위 검사                      | Connected 결과가 확인하는 내용              |
| -------------------------- | ---------------------------------- |
| <strong>Signaling</strong> | 보안 시그널링 연결이 설정되었습니다.               |
| <strong>ICE</strong>       | WebRTC 미디어 연결이 설정되었습니다.            |
| <strong>TURN</strong>      | 직접 경로를 사용할 수 없을 때 릴레이를 사용할 수 있습니다. |
| <strong>Media RTP</strong> | 생성된 테스트 미디어 패킷이 전송되고 있습니다.         |
| <strong>UDP path</strong>  | 선택된 미디어 경로에서 UDP 트래픽을 전송할 수 있습니다.  |

선택된 프로토콜과 후보 유형, 왕복 시간, 비트레이트, 전송된 패킷 수도 표시될 수 있습니다. <strong>Main API access</strong>는 통과했지만 가상 오피스의 오디오나 비디오 품질이 좋지 않다면 이 정보를 IT 관리자에게 전달하세요.

## 보고서 내보내기

<strong>Export report ZIP</strong>은 검사 결과가 통과, 경고, 실패 또는 미완료여도 사용할 수 있습니다.

1. 보고서에 포함할 검사를 실행합니다. 24개 항목을 한 번에 검사하려면 <strong>Run diagnostics</strong>를 선택합니다.
2. <strong>Export report ZIP</strong>을 선택합니다.
3. ZIP을 저장하고 조직에서 승인한 IT 관리자 또는 VoicePing 지원팀에만 공유합니다.

<Warning>
  진단 보고서에는 기기 및 네트워크 연결 정보가 포함될 수 있습니다. 공유하기 전에 조직의 지원 및 개인정보 보호 정책을 확인하세요.
</Warning>

## 검사가 완료되지 않는 경우

결과가 <strong>Checking</strong> 상태로 유지되면 다음을 시도하세요.

1. 해당 항목의 <strong>Check</strong>를 다시 선택합니다.
2. 운영체제에서 관련 권한이 켜져 있는지 확인합니다.
3. 같은 마이크나 카메라를 사용하는 다른 앱을 종료합니다.
4. VoicePing을 종료하고 다시 연 뒤 검사를 다시 실행합니다.
5. 현재 결과를 캡처합니다. 상태가 계속 바뀌지 않으면 워크스페이스 관리자에게 문의하거나 [제품 피드백](/ko/product-feedback) 페이지에서 보고합니다.

완료되지 않은 검사를 통과로 간주하지 마세요. 관리자나 VoicePing 지원팀이 미완료 상태를 확인할 수 있도록 <strong>Export report ZIP</strong>으로 현재 결과를 내보내세요.

<FeedbackKo />