MaaAssistantArknights/docs/ko-kr/protocol/integration.md

order, icon

order	icon
1	bxs:book

통합 문서

인터페이스 소개

AsstAppendTask

인터페이스 원형

AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* params);

인터페이스 설명

작업 추가

반환 값

• AsstTaskId
  추가 성공 시 해당 작업 ID 반환, 이후 작업 파라미터 설정에 사용 가능;
  추가 실패 시 0 반환

파라미터 설명

:::: field-group
::: field name="handle" type="AsstHandle" required
인스턴스 핸들
:::
::: field name="type" type="const char*" required
작업 유형
:::
::: field name="params" type="const char*" required
작업 파라미터, json string
:::
::::

작업 유형 목록

• StartUp
  시작 및 깨우기

:::: field-group
::: field name="enable" type="boolean" optional default="true"
본 작업 활성화 여부 :::
::: field name="client_type" type="string" required
클라이언트 버전

옵션: Official | Bilibili | txwy | YoStarEN | YoStarJP | YoStarKR
:::
::: field name="start_game_enabled" type="boolean" optional default="false"
클라이언트 자동 실행 여부
:::
::: field name="account_name" type="string" optional
계정 전환, 기본값은 전환하지 않음

로그인된 계정으로만 전환 가능하며, 로그인 이름으로 검색하므로 입력 내용이 로그인된 모든 계정 중 유일해야 함

공식 서버: 123****4567인 경우 123****4567, 4567, 123, 3****4567 입력 가능

Bilibili 서버: 张三인 경우 张三, 张, 三 입력 가능

번체 중국어 서버: 계정은 Email 형식이며(예: ab****01@gmail.com), 별표가 없는 평문 부분(예: 01@gmail) 입력을 권장합니다
:::
::::

Example

{
   "enable": true,
   "client_type": "Official",
   "start_game_enabled": true,
   "account_name": "123****4567"
}

• CloseDown
  게임 종료

:::: field-group
::: field name="enable" type="boolean" optional default="true"
본 작업 활성화 여부
:::
::: field name="client_type" type="string" required
클라이언트 버전, 비워두면 실행하지 않음

옵션: Official | Bilibili | txwy | YoStarEN | YoStarJP | YoStarKR
:::
::::

Example

{
   "enable": true,
   "client_type": "Official"
}

• Fight
  이성 사용 작전

:::: field-group
::: field name="enable" type="boolean" optional default="true"
본 작업 활성화 여부
:::
::: field name="stage" type="string" optional
스테이지명, 기본값은 비어 있음(현재/지난 스테이지 인식). 실행 중 설정 불가
"1-7", "S3-2" 등 모든 메인 스토리 스테이지 지원
스테이지명 끝에 -NORMAL/-HARD를 추가해 난이도 전환 가능 (10-14장은 표준/재앙, 15장 이후는 일반/험지)
섬멸 작전의 경우 반드시 "Annihilation" 입력
현재 진행 중인 SideStory의 뒤쪽 3개 스테이지는 반드시 전체 스테이지 번호를 입력해야 함
:::
::: field name="medicine" type="number" optional default="0"
이성 회복제 최대 사용 개수
:::
::: field name="medicine_expire_days" type="number" optional default="0"
지정된 일수 이내에 만료되는 이성 회복제를 사용합니다. 0은 만료 임박 이성 회복제를 사용하지 않음을 의미합니다.
:::
::: field name="expiring_medicine" type="number" optional default="0" deprecated
v6.8.0부터 폐기됨. 대신 medicine_expire_days를 사용하세요.
:::
::: field name="stone" type="number" optional default="0"
오리지늄 최대 사용 개수
:::
::: field name="times" type="number" optional default="2147483647"
전투 횟수
:::
::: field name="series" type="number" optional
연속 전투 횟수, -1~6
-1: 전환 비활성화
0: 현재 사용 가능한 최대 횟수로 자동 전환. 만약 현재 이성이 6회 미만이면 사용 가능한 최소 횟수 선택
1~6: 지정된 연속 전투 횟수
:::
::: field name="drops" type="object" optional
지정 드랍 수량, 기본값은 지정 안 함. key는 item_id, value는 수량. key는 resource/item_index.json 파일 참조
예: { "30011": 10, "30062": 5 }

위 조건들은 OR 관계이므로, 어느 하나라도 도달하면 작업 중지
:::
::: field name="report_to_penguin" type="boolean" optional default="false"
펭귄 물류(Penguin Stats) 데이터 전송 여부
:::
::: field name="penguin_id" type="string" optional
펭귄 물류 전송 ID, 기본값 비어 있음. report_to_penguin이 true일 때만 유효
:::
::: field name="server" type="string" optional default="CN"
서버, 드랍 인식 및 업로드에 영향
옵션: CN | US | JP | KR
:::
::: field name="client_type" type="string" optional
클라이언트 버전, 기본값 비어 있음. 게임 크래시 시 재시작 후 재접속하여 계속 파밍하는 용도. 비워두면 해당 기능 비활성화
옵션: Official | Bilibili | txwy | YoStarEN | YoStarJP | YoStarKR
:::
::: field name="DrGrandet" type="boolean" optional default="false"
이성 절약 모드, 오리지늄 사용 가능성이 있을 때만 유효
오리지늄 사용 확인 창에서 대기하다가, 현재 1이성이 회복되면 즉시 오리지늄을 사용
:::
::::

Example

{
   "enable": true,
   "stage": "1-7",
   "medicine": 1,
   "medicine_expire_days": 2,
   "stone": 0,
   "times": 10,
   "series": 0,
   "drops": {
      "30011": 10
   },
   "report_to_penguin": true,
   "penguin_id": "123456",
   "report_to_yituliu": true,
   "yituliu_id": "123456",
   "server": "CN",
   "client_type": "Official",
   "DrGrandet": false
}

일부 소수 자원 스테이지명도 지원합니다. 통합 예시를 참고하세요

• Recruit
  공개 모집

:::: field-group
::: field name="enable" type="boolean" optional default="true"
본 작업 활성화 여부
:::
::: field name="refresh" type="boolean" optional default="false"
3성 태그 새로고침 여부
:::
::: field name="select" type="array" required
클릭할 태그 등급
:::
::: field name="confirm" type="array" required
확인 클릭할 태그 등급. 공모 계산만 할 경우 빈 배열로 설정 가능
:::
::: field name="first_tags" type="array" optional
우선 태그, 태그 등급이 3일 때만 유효. 기본값 비어 있음
태그 등급이 3일 때, 여기에 있는 태그(존재하는 경우)를 가능한 많이 선택하며, 강제 선택이므로 "3성 태그 선택 안 함" 설정을 무시함 :::
::: field name="extra_tags_mode" type="number" optional default="0"
추가 태그 선택 모드
0 - 기본 동작
1 - 충돌 가능성 무시하고 태그 3개 선택
2 - 충돌 가능성 무시하고 가능한 많은 고성급 태그 조합 동시 선택
:::
::: field name="times" type="number" optional default="0"
모집 횟수. 공모 계산만 할 경우 0으로 설정 가능
:::
::: field name="set_time" type="boolean" optional default="true"
모집 시간 설정 여부. times가 0일 때만 유효
:::
::: field name="expedite" type="boolean" optional default="false"
즉시 완료 허가증 사용 여부
:::
::: field name="expedite_times" type="number" optional
즉시 완료 사용 횟수, expedite가 true일 때만 유효. 기본값은 무제한(즉 times 상한까지)
:::
::: field name="skip_robot" type="boolean" optional default="true"
폐기 예정이며 구형 파라미터 호환용으로만 유지됩니다.

preserve_tags가 없고 이 값이 true이면 支援机械 인식 시에만 건너뜁니다. 元素는 더 이상 구형 1★ 태그로 취급하지 않습니다.
::: ::: field name="preserve_tags" type="array" optional
현재 공개모집 슬롯을 유지한 채 이번 모집을 건너뛸 Tag 이름 목록입니다. 기본값은 빈 배열입니다.

지정한 Tag 중 하나라도 인식되면 MAA는 해당 슬롯을 유지하고 이번 모집을 건너뜁니다.
:::
::: field name="recruitment_time" type="object" optional
태그 등급(3 이상)과 대응하는 희망 모집 시간(분 단위), 기본값은 모두 540(즉 09:00:00)
예: { "3": 540, "4": 540 }
:::
::: field name="report_to_penguin" type="boolean" optional default="false"
펭귄 물류 데이터 전송 여부
:::
::: field name="penguin_id" type="string" optional
펭귄 물류 전송 ID, 기본값 비어 있음. report_to_penguin이 true일 때만 유효
:::
::: field name="report_to_yituliu" type="boolean" optional default="false"
Yituliu 데이터 전송 여부
:::
::: field name="yituliu_id" type="string" optional
Yituliu 전송 ID, 기본값 비어 있음. report_to_yituliu가 true일 때만 유효
:::
::: field name="server" type="string" optional default="CN"
서버, 업로드에 영향
옵션: CN | US | JP | KR
:::
::::

Example

{
   "enable": true,
   "refresh": true,
   "select": [5, 4],
   "confirm": [4, 3],
   "first_tags": ["高级资深干员"],
   "extra_tags_mode": 1,
   "times": 4,
   "set_time": true,
   "expedite": false,
   "expedite_times": 0,
   "preserve_tags": ["支援机械"],
   "recruitment_time": {
      "3": 540,
      "4": 540
   },
   "report_to_penguin": false,
   "penguin_id": "123456",
   "report_to_yituliu": false,
   "yituliu_id": "123456",
   "server": "CN"
}

• Infrast
  기반시설 교대

:::: field-group
::: field name="enable" type="boolean" optional default="true"
본 작업 활성화 여부
:::
::: field name="mode" type="number" optional default="0"
교대 작업 모드
0 - Default: 기본 교대 모드, 단일 시설 최적해
10000 - Custom: 사용자 정의 교대 모드, 사용자 설정 로드. 기반시설 스케줄링 프로토콜 참고
20000 - Rotation: 원터치 로테이션 모드. 제어 센터, 발전소, 숙소, 사무실은 건너뛰고, 나머지 시설은 교대하지 않지만 기본 조작(드론 사용, 응접실 로직 등)은 유지
:::
::: field name="facility" type="array" required
교대할 시설(순서 있음). 실행 중 설정 불가
시설명: Mfg | Trade | Power | Control | Reception | Office | Dorm | Processing | Training
:::
::: field name="drones" type="string" optional default="_NotUse"
드론 용도. mode = 10000일 때 이 필드는 무효
옵션: _NotUse | Money | SyntheticJade | CombatRecord | PureGold | OriginStone | Chip
:::
::: field name="threshold" type="number" optional default="0.3"
컨디션 임계값, 범위 [0, 1.0]
mode = 10000일 때 이 필드는 "autofill"에 대해서만 유효
mode = 20000일 때 이 필드는 무효
:::
::: field name="replenish" type="boolean" optional default="false"
무역소 "오리지늄 조각" 자동 보충 여부
:::
::: field name="dorm_notstationed_enabled" type="boolean" optional default="false"
작업 오퍼레이터 숙소 "미배치" 옵션 활성화 여부
:::
::: field name="dorm_trust_enabled" type="boolean" optional default="false"
숙소 남은 자리에 신뢰도 미만 오퍼레이터 배치 여부
:::
::: field name="reception_message_board" type="boolean" optional default="true"
응접실 게시판 크레딧 수령 여부
:::
::: field name="reception_clue_exchange" type="boolean" optional default="true"
단서 교환 수행 여부
:::
::: field name="reception_send_clue" type="boolean" optional default="true"
단서 보내기 여부
:::
::: field name="filename" type="string" required
사용자 정의 설정 경로. 실행 중 설정 불가

:::
::: field name="plan_index" type="number" required
설정 내 사용할 플랜 번호. 실행 중 설정 불가

:::
::::

Example

{
   "enable": true,
   "mode": 0,
   "facility": ["Mfg", "Trade", "Reception"],
   "drones": "PureGold",
   "threshold": 0.3,
   "replenish": true,
   "dorm_notstationed_enabled": false,
   "dorm_trust_enabled": true,
   "reception_message_board": true,
   "reception_clue_exchange": true,
   "reception_send_clue": true,
   "filename": "schedules/base.json",
   "plan_index": 1
}

• Mall
  크레딧 수령 및 상점 구매
  먼저 buy_first 목록 순서대로 구매하고, 그 다음 blacklist를 제외하고 왼쪽에서 오른쪽으로 구매하며, 크레딧이 넘칠 경우 블랙리스트를 무시하고 넘치지 않을 때까지 구매

:::: field-group
::: field name="enable" type="boolean" optional default="true"
본 작업 활성화 여부
:::
::: field name="visit_friends" type="boolean" optional default="true"
친구 기반시설을 방문하여 크레딧 획득 여부
:::
::: field name="shopping" type="boolean" optional default="true"
크레딧 상점 구매 수행 여부
:::
::: field name="buy_first" type="array" optional default="[]"
우선 구매 목록. 상품명, 예: "채용 허가증", "용문폐" 등
:::
::: field name="blacklist" type="array" optional default="[]"
구매 블랙리스트. 상품명, 예: "즉시 완료 허가증", "가구 부품" 등
:::
::: field name="force_shopping_if_credit_full" type="boolean" optional default="false"
크레딧 넘침 시 블랙리스트 무시 여부
:::
::: field name="only_buy_discount" type="boolean" optional default="false"
할인 상품만 구매 여부, 2차 구매(목록 순서 외)에만 적용
:::
::: field name="reserve_max_credit" type="boolean" optional default="false"
크레딧이 300 미만일 때 구매 중지 여부, 2차 구매에만 적용
:::
::: field name="credit_fight" type="boolean" optional default="false"
다음 날 더 많은 크레딧을 얻기 위해 지원을 빌려 OF-1 스테이지를 1회 클리어할지 여부
:::
::: field name="formation_index" type="number" optional default="0"
OF-1 플레이 시 사용할 편성 슬롯 번호
04의 정수, 0은 현재 편성, 14는 제1~4 편성
:::
::::

Example

{
   "enable": true,
   "visit_friends": true,
   "shopping": true,
   "buy_first": ["招聘许可", "龙门币"],
   "blacklist": ["家具零件"],
   "force_shopping_if_credit_full": false,
   "only_buy_discount": true,
   "reserve_max_credit": false,
   "credit_fight": false,
   "formation_index": 0
}

• Award
  각종 보상 수령

:::: field-group
::: field name="enable" type="boolean" optional default="true"
본 작업 활성화 여부
:::
::: field name="award" type="boolean" optional default="true"
일일/주간 임무 보상 수령
:::
::: field name="mail" type="boolean" optional default="false"
모든 우편 보상 수령
:::
::: field name="recruit" type="boolean" optional default="false"
한정 헤드헌팅 매일 무료 단차 수령
:::
::: field name="orundum" type="boolean" optional default="false"
합성옥 추첨(LUCKY WALL 등) 보상 수령
:::
::: field name="mining" type="boolean" optional default="false"
한정 채굴 허가(합성옥 채굴) 보상 수령
:::
::: field name="specialaccess" type="boolean" optional default="false"
5주년 등 이벤트 월정액 보상 수령
:::
::::

Example

{
   "enable": true,
   "award": true,
   "mail": true,
   "recruit": true,
   "orundum": false,
   "mining": true,
   "specialaccess": false
}

• Roguelike
  통합 전략 무한 반복

:::: field-group
::: field name="enable" type="boolean" optional default="true"
본 작업 활성화 여부
:::
::: field name="theme" type="string" optional default="Phantom"
테마
Phantom - 팬텀 & 크림슨 솔리테어
Mizuki - 미즈키 & 카이룰라 아버
Sami - 탐험가의 은빛 서리 끝자락
Sarkaz - 살카즈의 영겁 기담
JieGarden - 쉐이의 기이한 계원
:::
::: field name="mode" type="number" optional default="0"
모드
0 - 점수/보상 포인트 파밍, 가능한 안정적으로 많은 층수 도달
1 - 오리지늄 각뿔 파밍, 1층 투자 후 퇴각
2 - 모드 0과 1 겸용, 투자 후 퇴각, 투자할 게 없으면 계속 진행
3 - 개발 중..
4 - 스타트 리세마라, 난이도 0으로 3층 도달 후 재시작, 지정 난이도에서 스타트 보상 확인. 전기주전자나 희망이 아니면 난이도 0으로 돌아가 반복; Phantom 테마는 난이도 전환 없이 현재 난이도에서 반복
5 - 붕괴 패러다임 파밍; Sami 테마 전용; 전투 중 적을 흘려 붕괴치를 빠르게 누적, 첫 붕괴 패러다임이 expected_collapsal_paradigms 목록에 있으면 정지, 아니면 재시작
6 - 월간 소대 보상 파밍, 모드 적응 외엔 모드 0과 동일
7 - 심층 조사 보상 파밍, 모드 적응 외엔 모드 0과 동일
:::
::: field name="squad" type="string" optional default="指挥分队"
시작 분대명
:::
::: field name="roles" type="string" optional default="取长补短"
시작 모집 조합
:::
::: field name="core_char" type="string" optional
시작 오퍼레이터명. 단일 오퍼레이터 중문명만 지원(서버 무관); 비워두거나 ""이면 육성도에 따라 자동 선택
:::
::: field name="use_support" type="boolean" optional default="false"
시작 오퍼레이터를 지원 유닛으로 빌릴지 여부
:::
::: field name="use_nonfriend_support" type="boolean" optional default="false"
친구가 아닌 지원 유닛 사용 가능 여부. use_support가 true일 때만 유효
:::
::: field name="starts_count" type="number" optional default="2147483647"
탐색 시작 횟수. 도달 시 자동 정지
:::
::: field name="difficulty" type="number" optional default="0"
지정 난이도 등급. 미해금 시 현재 해금된 최고 난이도 선택
:::
::: field name="stop_at_final_boss" type="boolean" optional default="false"
5층 보스 노드 앞에서 정지할지 여부. Phantom 제외 테마에만 적용
:::
::: field name="stop_at_max_level" type="boolean" optional default="false"
통합 전략 만렙 도달 시 정지할지 여부
:::
::: field name="investment_enabled" type="boolean" optional default="true"
오리지늄각뿔 투자 여부
:::
::: field name="investments_count" type="number" optional default="2147483647"
투자 횟수. 도달 시 자동 정지
:::
::: field name="stop_when_investment_full" type="boolean" optional default="false"
투자 한도 도달 시 자동 정지 여부
:::
::: field name="investment_with_more_score" type="boolean" optional default="false"
투자 후 쇼핑 시도 여부. 모드 1에만 적용
:::
::: field name="start_with_elite_two" type="boolean" optional default="false"
스타트 리세마라 시 2차 정예화도 함께 노릴지 여부. 모드 4에만 적용
:::
::: field name="only_start_with_elite_two" type="boolean" optional default="false"
다른 스타트 조건 무시하고 2차 정예화만 노릴지 여부. 모드 4이고 start_with_elite_two가 true일 때만 유효
:::
::: field name="refresh_trader_with_dice" type="boolean" optional default="false"
주사위로 상점을 새로고침하여 특수 상품 구매 시도 여부. Mizuki 테마 전용, 길잡이 비늘 파밍용
:::
::: field name="first_floor_foldartal" type="string" optional
1층 원견 단계에서 얻길 희망하는 암호문. Sami 테마 전용, 모드 무관; 성공 시 정지
:::
::: field name="start_foldartal_list" type="array" optional default="[]"
스타트 리세마라 시 시작 보상으로 얻길 희망하는 암호문 목록. Sami 테마 모드 4일 때만 유효
목록의 모든 암호문을 보유해야 성공으로 간주
주의: "생존지상 분대"와 함께 사용해야 함. 다른 분대는 시작 보상으로 암호문을 얻지 못함
:::
::: field name="collectible_mode_start_list" type="object" optional
스타트 리세마라 시 희망 보상, 기본값은 모두 false. 모드 4일 때만 유효
hot_water: 전기주전자 보상, 파밍 매커니즘 트리거용 (공통)
shield: 보호막 값 보상, 추가 체력 (공통)
ingot: 오리지늄 각뿔 보상 (공통)
hope: 희망 보상 (공통, 주의: JieGarden 테마는 hope 보상 없음)
random: 랜덤 보상 옵션: 게임 내 "모든 각뿔을 소모하여 랜덤 소장품 1개 획득" (공통)
key: 열쇠 보상, Mizuki 테마 전용
dice: 주사위 보상, Mizuki 테마 전용
ideas: 구상 2개 보상, Sarkaz 테마 전용
ticket: 티켓 보상, JieGarden 테마 전용 :::
::: field name="use_foldartal" type="boolean" optional
암호문 사용 여부. 모드 5 기본값 false, 기타 모드 기본값 true. Sami 테마 전용
:::
::: field name="check_collapsal_paradigms" type="boolean" optional
획득한 붕괴 패러다임 감지 여부. 모드 5 기본값 true, 기타 모드 기본값 false
:::
::: field name="double_check_collapsal_paradigms" type="boolean" optional default="true"
붕괴 패러다임 누락 방지 검사 수행 여부. Sami 테마이고 check_collapsal_paradigms가 true일 때 유효. 모드 5 기본값 true, 기타 모드 기본값 false
:::
::: field name="expected_collapsal_paradigms" type="array" optional default="['目空一些', '睁眼瞎', '图像损坏', '一抹黑']"
희망하는 붕괴 패러다임. Sami 테마이고 모드 5일 때 유효
:::
::: field name="monthly_squad_auto_iterate" type="boolean" optional
월간 소대 자동 전환 활성화 여부
:::
::: field name="monthly_squad_check_comms" type="boolean" optional
월간 소대 통신 완료 여부도 전환 기준으로 삼을지 여부
:::
::: field name="deep_exploration_auto_iterate" type="boolean" optional
심층 조사 자동 전환 활성화 여부
:::
::: field name="collectible_mode_shopping" type="boolean" optional default="false"
파밍 중 쇼핑 활성화 여부
:::
::: field name="collectible_mode_squad" type="string" optional
파밍 중 사용할 분대, 기본적으로 squad와 동기화, squad가 비었고 이 값도 없으면 지휘 분대
:::
::: field name="start_with_seed" type="boolean" optional default="false"
시드를 사용하여 각뿔 파밍
Sarkaz 테마, Investment 모드, "연금술 분대" 또는 "지원 분대"일 때만 true 가능
고정 시드 사용
:::
::::

Example

{
   "enable": true,
   "theme": "Sami",
   "mode": 5,
   "squad": "指挥分队",
   "roles": "取长补短",
   "core_char": "塑心",
   "use_support": false,
   "use_nonfriend_support": false,
   "starts_count": 3,
   "difficulty": 8,
   "stop_at_final_boss": false,
   "stop_at_max_level": false,
   "investment_enabled": true,
   "investments_count": 2,
   "stop_when_investment_full": false,
   "investment_with_more_score": false,
   "start_with_elite_two": false,
   "only_start_with_elite_two": false,
   "refresh_trader_with_dice": false,
   "first_floor_foldartal": "",
   "start_foldartal_list": [],
   "collectible_mode_start_list": {
      "hot_water": true,
      "shield": false,
      "ingot": false,
      "hope": true,
      "random": false,
      "key": false,
      "dice": false,
      "ideas": false
   },
   "use_foldartal": true,
   "check_collapsal_paradigms": true,
   "double_check_collapsal_paradigms": true,
   "expected_collapsal_paradigms": ["目空一些", "睁眼瞎"],
   "monthly_squad_auto_iterate": false,
   "monthly_squad_check_comms": false,
   "deep_exploration_auto_iterate": false,
   "collectible_mode_shopping": false,
   "collectible_mode_squad": "",
   "start_with_seed": false
}

붕괴 패러다임 파밍 기능에 대한 자세한 내용은 통합 전략 보조 프로토콜을 참고하세요.

• Copilot
  자동지휘

:::: field-group
::: field name="enable" type="boolean" optional default="true"
본 작업 활성화 여부
:::
::: field name="filename" type="string"
단일 작전 JSON 파일 경로, copilot_list와 택일(필수); 상대/절대 경로 모두 가능
:::
::: field name="copilot_list" type="array