기기 창

Android 에뮬레이터와 기기의 화면을 보며 AI와 함께 조작합니다.

사용 가이드한국어

기기 창을 쓰기 전에

기기 창은 세션의 작업 공간에 Android 기기 하나를 붙여 그 화면을 보여 주고, 사람과 AI가 함께 조작하게 합니다. 에뮬레이터(가상 기기)와 USB로 연결한 실제 기기를 쓸 수 있습니다. iOS는 아직 지원하지 않습니다.

기기 창은 이 PC(또는 서버)의 Android 도구를 씁니다.

adb — USB 기기와 이미 켠 에뮬레이터는 adb만 있으면 됩니다.
에뮬레이터와 가상 기기 — Android Studio를 한 번 열어 설정 마법사를 마치면 에뮬레이터가 SDK 위치에 깔립니다. 가상 기기는 Android Studio › Device Manager에서 만듭니다.
하드웨어 가속 — Windows의 WHPX, macOS의 Hypervisor.framework, Linux의 KVM 같은 가속이 없으면 가상 기기가 켜지지 않습니다.

설정 › 실행 환경의 Android 도구 카드가 adb · 에뮬레이터 · 가상 기기를 찾았는지 보여 줍니다. 없으면 카드의 버튼이 공식 설치 명령을 새 터미널에 쳐 둡니다. Enter는 직접 누르세요(한 줄 설치가 없는 운영체제에서는 공식 안내를 엽니다). SDK를 다른 곳에 두었다면 Android SDK 위치에 적습니다. 비워 두면 ANDROID_HOME · ANDROID_SDK_ROOT · 기본 위치 순서로 찾습니다.

기기 창 열기

기기 창은 세션 하나의 작업 공간에 붙습니다. 먼저 세션을 연 뒤 다음 중 하나로 엽니다.

Dock의 기기 타일을 누릅니다. 열린 기기 창이나 붙은 기기가 있으면 그 목록이 열리고, 없으면 지금 세션의 기기 창이 열립니다.
세션 탭 메뉴에서 기기 열기를 고릅니다.
세션의 AI가 orke emulator attach --focus로 기기를 붙이면 그 기기 창이 화면에 열립니다.

작업 공간 하나에는 기기 창 하나가 있습니다. 격리 환경의 세션에서는 기기 창을 열 수 없습니다.

기기 고르기와 켜기

기기가 붙지 않은 창은 「어느 기기를 열까요?」 목록을 보여 줍니다.

켜져 있는 에뮬레이터와 USB 기기는 「연결됨」으로 보이고 열기를 누르면 바로 화면이 나옵니다.
꺼진 가상 기기는 「꺼짐」으로 보이고 켜기를 누르면 orke가 창 없이 켭니다. 처음 켜는 가상 기기는 1–2분 걸릴 수 있습니다. 기다리는 동안 켜기 취소로 멈출 수 있고, 3분 안에 켜지지 않으면 orke가 기다림을 멈추고 알려 줍니다.
USB 기기는 개발자 옵션의 USB 디버깅을 켜야 목록에 보입니다.

화면을 보며 조작하기

화면을 누르면 기기를 탭하고, 끌면 밉니다.
옆의 기기 버튼으로 뒤로 · 홈 · 최근 앱 · 회전 · 전원 버튼 · 볼륨을 누릅니다.
글자 보내기는 기기에서 고른 입력 칸에 글을 넣습니다. 영문 · 숫자 · 기호만 보낼 수 있고 줄바꿈은 보내지 않습니다. 한글은 기기 화면의 키보드로 입력하세요.
화면은 실시간 영상입니다. 영상이 오지 않으면 2초마다 바뀌는 정지 화면으로 보여 주고 화면 위에 그렇게 알립니다.

항목	하는 일
다른 기기로 바꾸기…	목록으로 돌아가 다른 기기를 엽니다. 앞의 Android 기기는 켜 둡니다.
영상 멈추기 · 영상 다시 보기	화면 영상만 멈추거나 다시 엽니다. 기기는 켜 둡니다.
기기 끄기…	가상 기기를 끕니다. 한 번 더 확인을 묻습니다.
설정 › 실행 환경 열기	Android 도구 카드로 갑니다.

AI와 같은 기기 쓰기

기기 창은 세션의 기기를 보여 주고, 그 세션의 AI도 같은 기기를 씁니다. AI는 orke emulator 명령으로 화면을 읽고(ax · screenshot), 누르고(tap · gesture · button), 글을 넣고(type), 앱을 설치하고 실행합니다(install · launch). 예를 들어 “에뮬레이터에서 설정 앱을 열고 와이파이 화면을 확인해줘”처럼 부탁하세요.

AI가 누르는 동안에는 기기 창 위에 「(AI 이름)가 이 기기를 조작 중 · 손대면 사람 입력이 먼저 갑니다」 띠가 뜹니다. 사람과 AI의 입력은 기기마다 한 줄로 서고, 사람이 먼저입니다.

Android 도구를 찾은 PC에서는 orke가 Claude · Codex · Antigravity에 기기 사용 안내를 깔아 둡니다. NVIDIA 에이전트는 같은 기능을 내장 도구로 씁니다.

폰 · 태블릿에서 보기

원격 접속으로 폰이나 태블릿에서 orke를 열면 작업 목록의 기기 메뉴에 기기가 붙은 세션마다 한 줄이 있습니다. 줄을 누르면 기기 화면이 열립니다. 폰은 아래 줄에 뒤로 · 홈 · 최근 앱 · 회전 · 글자 보내기 · ⋯가 있고, 전원과 볼륨은 ⋯ 안에 있습니다. 태블릿은 오른쪽에 키 열이 있습니다. 손가락으로 누르고 밀면 기기에 그대로 갑니다.

닫기와 정리

기기 창을 닫아도 기기는 켜진 채로 남고, 그 세션의 AI도 계속 쓸 수 있습니다. orke를 끝내면 orke가 켠 가상 기기와 화면 전송 도구만 정리합니다. 사람이 켠 에뮬레이터와 adb 서버는 그대로 둡니다.

연결이 끊기면

에뮬레이터가 꺼지거나 adb가 응답하지 않으면 마지막 화면이 흐려지고 orke가 다시 연결을 시도합니다. 그래도 안 되면 「기기와 연결이 끊겼습니다」 안내와 다시 연결 · 다른 기기 버튼이 나옵니다. 기기를 다시 켠 뒤 다시 연결하거나 다른 기기를 고르세요. 「Android 도구가 없습니다」가 보이면 기기 창을 쓰기 전에를 확인하세요.