블루스택 멀티 인스턴스 매크로: MAS 기기 그룹 설정

기기 그룹은 Macro Automation Studio(MAS)가 여러 기기에서 매크로를 실행할 때 쓰는 단위이며, 블루스택 멀티 인스턴스 구성이든 클라우드 기기 묶음이든 같은 방식입니다. 블루스택 멀티 인스턴스 창 각각은 그룹 안에서 자체 매크로, 인수, 프록시, 웹훅을 가지며, 그룹에는 Start All과 Stop All이 있습니다. 이 페이지는 두 가지 그룹 종류, 기기별 설정, 일괄 실행, 로그, 예약을 다룹니다.

시작하기 전에

• MAS가 설치되어 있고 활성 체험 또는 요금제로 로그인한 상태.
• 로컬 그룹의 경우: ADB가 켜진 에뮬레이터 인스턴스 하나 이상이 실행 중. 포트 규칙은 기기를 참고하세요.
• 클라우드 그룹의 경우: Cloud Devices 페이지에서 만든 클라우드 기기 하나 이상. 클라우드 기기를 참고하세요. 추가 옵션에 무엇이 포함되는지는 클라우드 기기 페이지에 있습니다.

두 종류의 그룹

그룹은 한 종류의 기기만 담으며, 만들 때 정하고 이후 바꿀 수 없습니다:

클라우드 기기는 클라우드 그룹에만, 에뮬레이터는 로컬 그룹에만 들어갈 수 있습니다. 섞으면 “a cloud device can only be added to a cloud group”으로 거부됩니다.

그룹 만들기

1. 사이드바에서 Device Groups를 열고 Create New Group을 클릭합니다.
2. 3자에서 255자의 Name과 선택적인 Description을 입력합니다.
3. Type을 고릅니다: Local 또는 Cloud.
4. Create Group을 클릭합니다.

그룹 목록에 모든 그룹이 기기 수와 실행 중인 기기의 실시간 수와 함께 표시됩니다. 그리드 또는 표 보기를 쓰고, 이름, 생성 시점, 기기 수로 정렬하고, 이름으로 검색할 수 있습니다. Edit는 이름과 설명을 바꾸며, 종류는 바꿀 수 없습니다.

기기 추가

BlueStacks, LDPlayer와 그 밖의 멀티 인스턴스 안드로이드 에뮬레이터

에뮬레이터 인스턴스마다 자기 adb 포트로 수신하며, MAS는 모든 포트를 별도 기기로 취급합니다. 따라서 BlueStacks 창 세 개나 LDPlayer 인스턴스 세 개는 그룹 안에서 기기 세 개가 되고, 각각 자기 매크로와 인수를 가집니다. 각 인스턴스의 포트 위치는 BlueStacks, LDPlayer, MuMu Player, MEmu 가이드에 있으며, 멀티 인스턴스 가이드가 전체 구성을 안내합니다.

기기별 설정

모든 기기 카드에는 같은 컨트롤이 있습니다:

• Macro: 이 기기가 실행할 매크로를 고릅니다. 매크로가 없는 기기는 Start All에서 건너뜁니다.
• Macro settings: 이 기기용 매크로 인수 폼을 엽니다. 위쪽 Profile 바가 값이 어디에 저장될지 정합니다: 그 프로필을 따르는 모든 기기가 공유하는 이름 있는 설정 프로필, 또는 Custom (this device only). 프로필을 저장하면 그것을 쓰는 모든 기기가 갱신되며, 바에 몇 대인지 표시됩니다. 모든 매크로에는 삭제할 수 없는 Default 프로필이 있습니다. New는 현재 값을 새 프로필로 저장합니다.
• Run Count: 이 기기에서 매크로를 몇 번 반복할지.
• Advanced settings: Proxy 선택기, 이 기기에 대해 알림받는 웹훅 수와 Manage 링크가 있는 Notifications 줄, Proxy data today.
• Edit Device는 이름과 포트를 바꾸고, 휴지통 버튼은 그룹에서 기기를 제거합니다.

매크로나 실행 횟수를 편집한 뒤에는 Save Changes를 클릭하세요. 프록시와 프로필 선택은 저절로 저장됩니다.

기기별 프록시

Proxy 드롭다운에서 프록시를 고릅니다. No proxy는 해제합니다. 기기당 프록시 하나이며, 기본은 sticky라 기기마다 자기 IP를 유지합니다. 에뮬레이터에서는 각 실행 동안 프록시가 적용되고, 클라우드 기기에서는 기기가 다음에 시작할 때 적용됩니다. 세부 사항, 제한, 웹훅의 출구 IP는 프록시 페이지에 있습니다.

기기별 웹훅

웹훅 엔드포인트는 Webhooks 페이지에서 모든 기기, 선택한 그룹, 또는 선택한 기기로 범위를 정합니다. 기기 카드는 이 기기를 다루는 엔드포인트 수만 보여 주며, 범위는 Webhooks 페이지에서 바꿉니다. 실행 이벤트에는 device_id, device_name, device_port, group_id가 담기므로 엔드포인트 하나로 기기를 구별할 수 있습니다. 웹훅을 참고하세요.

시작과 정지

카드의 Start는 그 기기만 실행합니다. 로컬 기기는 MAS가 adb로 연결해 매크로를 실행하고, 클라우드 기기는 서버 실행을 시작합니다.

Start All은 그룹 전체를 실행합니다:

• 기기가 목록 순서대로 0.5초 간격으로 차례로 시작됩니다.
• 매크로가 지정되지 않은 기기는 건너뛰고 실패로 세며, 나머지는 그대로 시작됩니다.
• 결과는 개수로 표시됩니다. 예를 들어 9대 성공, 1대 실패이며, 토스트에 오류 메시지가 최대 5개 표시됩니다. Starting All Devices 대화 상자에 진행 상황과 작업 로그가 표시됩니다.
• 클라우드 그룹에서는 Start All이 기기마다 서버 실행을 차례로 시작합니다. 요금제의 실행 중 기기 제한이 여전히 적용되므로, 시작할 수 없는 기기는 자기 토스트로 알립니다.

Stop All은 같은 방식으로 그룹의 모든 실행을 끝냅니다. 클라우드 실행을 정지해도 클라우드 기기는 켜진 채로 남습니다.

각 카드에 상태가 표시됩니다: Stopped, Connecting, Downloading, Starting, Running, Stopping 또는 Error. 그룹 헤더는 이를 실행 중, 유휴, 오류 수로 요약합니다.

기기별 로그

모든 카드에는 매크로에 런타임 UI가 있을 때 이를 보여 주는 Dashboard 탭과, 기기 자체 출력이 담기는 Logs 탭이 있습니다:

• All, User, Exec, Errors, Warnings로 필터링합니다. User 줄은 스크립트 자체의 print와 mas.log 출력이고, Exec 줄은 실행기에서 옵니다.
• Search logs는 텍스트로 필터링하고, Follow는 최신 줄이 보이게 유지하며, Time은 타임스탬프를 켜고 끕니다.
• Save는 로그를 파일로 쓰고, Clear는 창을 비웁니다.

프록시와 웹훅 이벤트도 같은 창에 나타납니다. 예를 들어 “Proxy connected via office, traffic routed through 203.0.113.9”입니다. 클라우드 기기의 창에는 서버 실행 출력의 끝부분이 표시됩니다. 종료 코드와 소요 시간이 있는 완료된 실행은 Runs에 나열됩니다.

그룹 예약

스케줄러는 기기 중에서 고른 포트 하나에서 매크로 하나를 지정한 시간에 실행합니다. 그룹 전체를 예약하려면 같은 시간과 반복으로 기기마다 작업 하나를 만드세요. 그룹에 속한 기기의 예약 실행에는 그 그룹의 ID가 담기므로 그룹 범위 웹훅도 발생합니다.

API 키용 그룹과 기기 경로

API 키로 그룹과 기기를 읽을 수 있습니다: GET /api/emulator/groups와 GET /api/emulator/devices. 둘 다 키 소유자가 가진 것만 반환하며, 기기 행에는 포트, 매크로, 그룹, 설정 프로필이 들어 있습니다. 그룹이나 기기를 만들고, 편집하고, 삭제하고, 시작하고, 정지하는 데는 앱 자체 로그인이 필요합니다. REST API를 참고하세요.

문제 해결

Start All이 실패한 기기를 보고함

토스트나 작업 로그를 여세요. “device X has no macro assigned”는 카드에 Macro가 선택되지 않았다는 뜻입니다. 연결할 수 없는 로컬 기기는 adb 오류로 실패합니다. ADB 문제 해결을 따르세요. 시작된 기기는 계속 실행됩니다.

클라우드 기기가 그룹에 들어가지 않음

그룹이 로컬 그룹입니다. Type을 Cloud로 설정한 그룹을 만들고 거기에 기기를 추가하세요. 같은 규칙으로 에뮬레이터는 클라우드 그룹에 들어갈 수 없습니다.

인스턴스 두 개가 같은 포트를 표시함

포트마다 기기 하나에 속합니다. 에뮬레이터 창 두 개가 같은 포트를 보고하면 하나는 ADB가 꺼져 있거나 완전히 부팅되지 않은 것입니다. 두 번째 인스턴스의 부팅이 끝나기를 기다린 뒤 포트 목록에서 Refresh를 클릭하고 자기 포트로 추가하세요.