mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-16 09:50:40 +08:00
7e1e7ec3d5
* docs: manual * docs: protocol * docs: develop * chore: fix typo * chore: fix more typo * docs: readme readme image * chore: Auto update by pre-commit hooks [skip changelog] * fix: corrected file name --------- Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
486 lines
25 KiB
Markdown
486 lines
25 KiB
Markdown
---
|
||
order: 1
|
||
icon: bxs:book
|
||
---
|
||
|
||
# 통합문서
|
||
|
||
## API
|
||
|
||
### `AsstAppendTask`
|
||
|
||
#### 프로토타입
|
||
|
||
```cpp
|
||
TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* params);
|
||
```
|
||
|
||
#### 설명
|
||
|
||
작업을 추가합니다.
|
||
|
||
#### 반환 값
|
||
|
||
- `TaskId`
|
||
작업이 성공적으로 추가되면 작업 ID가 반환됩니다.
|
||
그렇지 않으면 0이 반환됩니다.
|
||
|
||
#### 매개변수 설명
|
||
|
||
- `AsstHandle handle`
|
||
인스턴스 핸들
|
||
- `const char* type`
|
||
작업 유형
|
||
- `const char* params`
|
||
JSON 형식의 작업 매개변수
|
||
|
||
##### 작업 유형 목록
|
||
|
||
- `StartUp`
|
||
게임 시작
|
||
|
||
```json5
|
||
// 해당 작업 매개변수
|
||
{
|
||
"enable": bool, // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
|
||
"client_type": string, // 클라이언트 타입이 필요합니다.
|
||
// 옵션: "Official" | "Bilibili" | "txwy" | "YoStarEN" | "YoStarJP" | "YoStarKR"
|
||
"start_game_enabled": bool, // 클라이언트를 자동으로 실행할지 여부, 선택 사항, 기본값은 false
|
||
"account_name": string // 계정 전환, 선택 사항, 기본값은 전환하지 않음
|
||
// 이미 로그인된 계정으로만 전환 가능, 로그인 이름으로 검색, 모든 로그인된 계정에서 고유한 입력 내용 보장 필요
|
||
}
|
||
```
|
||
|
||
- `CloseDown`
|
||
게임 종료
|
||
|
||
```json5
|
||
// 해당 작업 매개변수
|
||
{
|
||
"enable": bool, // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
|
||
"client_type": string, // 클라이언트 버전이 필수이며, 빈칸을 채우지 않으면 실행되지 않습니다.
|
||
// 옵션: "Official" | "Bilibili" | "txwy" | "YoStarEN" | "YoStarJP" | "YoStarKR"
|
||
}
|
||
```
|
||
|
||
- `Fight`
|
||
작전
|
||
|
||
```json5
|
||
// 해당 작업 매개변수
|
||
{
|
||
"enable": bool, // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
|
||
"stage": string, // 스테이지 이름, 선택 사항, 기본적으로 현재/마지막 스테이지로 설정됩니다. 실행 중에 편집할 수 없습니다.
|
||
// "1-7", "S3-2" 등 모든 메인스토리 스테이지를 지원합니다.
|
||
// 레벨 끝에서 노말/하드를 입력하여 노말과 하드 난이도를 전환할 수 있습니다.
|
||
// "CE-6" 등 일부 특수 스테이지를 지원합니다. (C# 통합 예시 참조)
|
||
"medicine": int, // 최대 사용 가능한 이성 회복제 수, 선택 사항, 기본값은 0
|
||
"expiring_medicine": int, // 48시간 이내에 만료되는 이성 회복제 수, 선택 사항, 기본값은 0
|
||
"stone": int, // 최대 사용 가능한 오리지늄의 수, 선택 사항, 기본값은 0
|
||
"times": int, // 최대 반복 횟수, 선택 사항, 기본값은 무한대입니다.
|
||
"series": int, // 연전 횟수, 선택사항, 1~6
|
||
// -1 시리즈 전환을 비활성화하려면
|
||
// 0 현재 사용 가능한 최대 시리즈 수로 자동 전환하려면, 현재 사용 가능한 횟수가 6회 미만인 경우 사용 가능한 최소 횟수를 선택하세요.
|
||
// 1~6 지정된 횟수로 변경하려면
|
||
"drops": { // 드랍 수량을 지정합니다. 선택 사항, 기본적으로 지정되지 않습니다.
|
||
"30011": int, // 키: 아이템 ID; 값: 아이템 수량. 키는 resource/item_index.json을 참조합니다.
|
||
"30062": int // OR 조합
|
||
},
|
||
/* 아이템은 OR 연산자와 결합되며, 즉 어떤 조건을 만족하면 작업이 중지됩니다. */
|
||
|
||
"report_to_penguin": bool, // Pengiun Stats에 데이터를 업로드할지 여부, 선택 사항, 기본값은 false
|
||
"penguin_id": string, // Pengiun Stats ID, 선택 사항, 기본값은 빈 문자열입니다. `report_to_penguin`이 `true`인 경우에만 사용할 수 있습니다.
|
||
"server": string, // 서버, 선택 사항, 기본값은 "CN"입니다. 재료 드랍 인식과 업로드에 영향을 미칩니다.
|
||
// 옵션: "CN" | "US" | "JP" | "KR"
|
||
"client_type": string, // 클라이언트 버전, 선택 사항, 기본값은 빈 문자열입니다. 게임이 충돌한 후 다시 연결하는 데 사용됩니다. 빈 값은 이 기능을 비활성화합니다.
|
||
// 옵션: "Official" | "Bilibili" | "txwy" | "YoStarEN" | "YoStarJP" | "YoStarKR"
|
||
"DrGrandet": bool, // 오리지늄을 사용하여 "이성을 절약하는(매우 중요)" 옵션, 선택 사항, 기본값은 false입니다. 오리지늄을 사용해야하는 경우에만 유효합니다.
|
||
// 이성 1 포인트가 복구되면 오리지늄을 사용하여 확정화면에서 대기한 다음 즉시 오리지늄을 사용합니다.
|
||
}
|
||
```
|
||
|
||
특수 스테이지의 일부를 지원합니다. 자세한 내용은 [자동 현지화 예제](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/tools/AutoLocalization/example/ko-kr.xaml#L233)를 참고하세요.
|
||
|
||
- `Recruit`
|
||
공개모집
|
||
|
||
```json5
|
||
// 해당 작업 매개변수
|
||
{
|
||
"enable": bool, // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
|
||
"refresh": bool, // 3★ 태그를 새로 고칠지 여부, 선택 사항, 기본값은 false
|
||
"select": [ // 클릭할 태그 레벨, 필수
|
||
int,
|
||
...
|
||
],
|
||
"confirm": [ // 확인용 태그 레벨, 필수. 계산용으로만. 빈 배열로 설정할 수 있습니다.
|
||
int,
|
||
...
|
||
],
|
||
"first_tags": [ // 기본 태그, 태그 레벨이 3인 경우에만 유효합니다. 선택 사항, 기본값은 비어 있습니다.
|
||
string, // 태그 레벨이 3이면 여기에 있는 태그(있는 경우)가 최대한 많이 선택됩니다.
|
||
... // 또한 강제 선택이므로 '3등급 태그 선택 해제' 설정은 모두 무시됩니다.
|
||
],
|
||
"extra_tags_mode": int, // 더 많은 태그 선택, 선택 사항, 기본값은 0
|
||
// 0 - 기본 동작
|
||
// 1 - 태그 3개 선택, 충돌 가능
|
||
// 2 - 가능한 경우 더 많은 고성급 태그 조합을 동시에 선택, 충돌 가능
|
||
"times": int, // 고용 횟수, 선택 사항, 기본값은 0입니다. 계산용으로만 0으로 설정할 수 있습니다.
|
||
"set_time": bool, // 시간을 9시간으로 설정할지 여부, `times`가 0인 경우에만 사용 가능한 옵션입니다, 선택 사항, 기본값은 true입니다.
|
||
"expedite": bool, // 즉시 완료 허가증을 사용할지 여부, 선택 사항, 기본값은 false입니다.
|
||
"expedite_times": int, // 즉시 완료 허가증을 사용할 횟수, `expedite`가 `true`일 때만 사용 가능한 옵션입니다, 선택 사항, 기본적으로 `times`가 한도에 도달할 때까지 무한대입니다.
|
||
"skip_robot": bool, // 로봇 태그가 인식될 때 건너뛸지 여부, 선택 사항, 기본값은 건너뛰기입니다.
|
||
"recruitment_time": { // 태그 레벨과 지속 시간(분)을 설정합니다, 선택 사항, 기본값은 540(9시간)입니다.
|
||
"3": int,
|
||
"4": int,
|
||
...
|
||
},
|
||
"report_to_penguin": bool, // Penguin Stats에 보고할지 여부, 선택 사항, 기본값은 false입니다.
|
||
"penguin_id": string, // Penguin Stats 사용자 ID, 선택 사항, 기본값은 빈 문자열입니다. `report_to_penguin`이 `true`인 경우에만 사용할 수 있습니다.
|
||
"report_to_yituliu": bool, // YITULIU에 보고할지 여부, 선택 사항, 기본값은 false입니다.
|
||
"yituliu_id": string, // YITULIU 사용자 ID, 선택 사항, 기본값은 빈 문자열입니다. `report_to_yituliu`이 `true`인 경우에만 사용할 수 있습니다.
|
||
"server": string, // 서버, 선택 사항, 기본값은 "CN"입니다. 업로드에 영향을 미칩니다.
|
||
}
|
||
```
|
||
|
||
- `Infrast`
|
||
기반시설 교대
|
||
|
||
```json5
|
||
{
|
||
"enable": bool, // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
|
||
"mode": int, // 전환 모드, 선택 사항입니다. 실행 중에는 편집할 수 없습니다.
|
||
// 0 - 기본값, 자동 전환
|
||
// 10000 - 사용자 정의 모드, 인프라 스키마 문서를 참조하세요.
|
||
// 20000 - 로테이션: 원키 로테이션 모드로 제어센터, 발전소, 기숙사, 사무실을 스킵하고, 기타 시설은 교대근무를 하지 않고 기본 운영(드론 사용, 접수실 로직 등)을 그대로 유지
|
||
"facility": [ // 전환할 시설, 필수입니다. 실행 중에 편집할 수 없습니다.
|
||
string, // 시설 이름: "Mfg" | "Trade" | "Power" | "Control" | "Reception" | "Office" | "Dorm"
|
||
...
|
||
],
|
||
"drones": string, // 드론 사용, 선택 사항, 기본값은 "_NotUse"입니다.
|
||
// "_NotUse"、"Money"、"SyntheticJade"、"CombatRecord"、"PureGold"、"OriginStone"、"Chip"
|
||
"threshold": float, // 의욕 임계값, 범위 [0, 1.0], 선택 사항, 기본값은 0.3입니다.
|
||
"replenish": bool, // 오리지늄 조각을 보충할지 여부, 선택 사항, 기본값은 false입니다.
|
||
"dorm_notstationed_enabled": bool, // "비어 있지 않음" 옵션을 활성화할지 여부, 기본값은 false입니다.
|
||
"dorm_trust_enabled": bool, // 숙소에서 신뢰도작을 할지에 대한 여부, 기본값은 false입니다.
|
||
|
||
/* 다음은 mode == 10000일 때만 유효합니다 */
|
||
"filename": string, // 사용자 정의 구성 json 파일 경로
|
||
"plan_index": int, // 사용자 정의 구성 플랜 인덱스
|
||
}
|
||
```
|
||
|
||
- `Mall`
|
||
크레딧 수집 및 자동 구매
|
||
"구매 우선 항목" 목록에 따라 순서대로 아이템을 구매하며 "무시 항목"에 있는 항목을 무시하고 크레딧이 넘칠 때까지 다른 항목을 순서대로 구매합니다.
|
||
|
||
```json5
|
||
// 해당 작업 매개변수
|
||
{
|
||
"enable": bool, // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
|
||
"shopping": bool, // 상점에서 아이템을 구매할지 여부, 선택 사항, 기본값은 false입니다. 실행 중에 편집할 수 없습니다.
|
||
"buy_first": [ // 우선적으로 구매할 아이템 목록, 선택 사항입니다. 실행 중에 편집할 수 없습니다.
|
||
string, // 아이템 이름, 예: "招聘许可" (모집 허가증), "龙门币" (용문폐) 등
|
||
...
|
||
],
|
||
"blacklist": [ // 블랙리스트, 선택 사항입니다. 실행 중에 편집할 수 없습니다.
|
||
string, // 아이템 이름, 예: "加急许可" (즉시 완료 허가증), "家具零件" (가구 부품) 등
|
||
...
|
||
],
|
||
"force_shopping_if_credit_full": bool // 크레딧이 넘친다면 블랙리스트를 무시할지 여부, 기본값은 true입니다.
|
||
"only_buy_discount": bool // 크레딧 포인트가 300 미만으로 떨어질 때 구매를 중단할지 여부입니다. 기본적으로 두 번째 구매 시에만 적용되며 기본값은 false입니다.
|
||
"reserve_max_credit": boll // 크레딧 포인트가 300 미만으로 떨어질 때 구매를 중단할지 여부. 기본적으로 두 번째 구매 시에만 적용되며 기본값은 false입니다.
|
||
}
|
||
```
|
||
|
||
- `Award`
|
||
임무 보상 수령
|
||
|
||
```json5
|
||
// 해당 작업 매개변수
|
||
{
|
||
"enable": bool // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
|
||
}
|
||
```
|
||
|
||
- `Roguelike`
|
||
통합전략
|
||
|
||
```json5
|
||
// 해당 작업 파라미터
|
||
{
|
||
"enable": bool, // 작업을 활성화할지 여부, 선택 가능, 기본값 true
|
||
"theme": string, // 테마, 선택 가능, 기본값 "Phantom"
|
||
// Phantom - 괴영과 주홍색 혈다이아
|
||
// Mizuki - 수월과 심해의 나무
|
||
// Sami - 탐색자의 은서림의 종점
|
||
// Sarkaz - 사카즈의 끝없는 기묘담
|
||
// JieGarden - 界园
|
||
"mode": int, // 모드, 선택 가능, 기본값 0
|
||
// 0 - 점수/보상 포인트 획득, 가능한 한 안정적으로 더 많은 층 도달
|
||
// 1 - 원석 정 수집, 첫 층에서 투자 후 종료
|
||
// 2 - 【폐지됨】모드 0과 1을 겸한 방식, 투자 후 종료하고 투자 없으면 계속 진행
|
||
// 3 - 개발 중…
|
||
// 4 - 시작 리셋, 난이도 0에서 3층 도달 후 리셋, 지정된 난이도로 리셋 보상 시도. 열쇠 아이템이 뜨지 않으면 난이도 0으로 돌아감;
|
||
// Phantom 테마에서는 난이도 변경 없이 현재 난이도에서 3층 도달 후 리셋 및 시작 리셋 시도
|
||
// 5 - 붕괴 패러다임 수집; Sami 테마에만 해당; 전투에서 적을 놓쳐 붕괴 수치를 빠르게 누적시킴.
|
||
// 첫 붕괴 패러다임이 expected_collapsal_paradigms 리스트에 있으면 작업 중지, 없으면 리셋
|
||
"squad": string, // 시작 시 부대명, 선택 가능, 기본값 "지휘 부대"
|
||
"roles": string, // 시작 직업 그룹, 선택 가능, 기본값 "적재적소 활용"
|
||
"core_char": string, // 시작 캐릭터 이름, 선택 가능; 단일 캐릭터 **한국어 이름**만 지원, 서버 무관; 비우거나 ""로 설정하면 자동으로 숙련도 기반 선택
|
||
"use_support": bool, // 시작 캐릭터가 지원 캐릭터인지 여부, 선택 가능, 기본값 false
|
||
"use_nonfriend_support": bool, // 비친구 지원 캐릭터 사용 가능 여부, 선택 가능, 기본값 false; use_support가 true일 때만 유효
|
||
"starts_count": int, // 탐색 시작 횟수, 선택 가능, 기본값 INT_MAX; 도달 시 자동으로 작업 중지
|
||
"difficulty": int, // 난이도 설정, 선택 가능, 기본값 0; **Phantom 제외** 테마에만 해당;
|
||
// 해제되지 않은 경우, 현재 해제된 최고 난이도 선택
|
||
"stop_at_final_boss": bool, // 5층 최종 보스 노드에서 작업을 중지할지 여부, 선택 가능, 기본값 false; **Phantom 제외** 테마에만 해당
|
||
"stop_at_max_level": bool, // 로그라이크에서 최대 레벨에 도달했을 때 작업을 멈출지 여부, 선택 가능, 기본값 false
|
||
"investment_enabled": bool, // 원석 정을 투자할지 여부, 선택 가능, 기본값 true
|
||
"investments_count": int, // 원석 정 투자 횟수, 선택 가능, 기본값 INT_MAX; 도달 시 자동으로 작업 중지
|
||
"stop_when_investment_full": bool, // 투자 한도 도달 시 작업을 자동 중지할지 여부, 선택 가능, 기본값 false
|
||
"investment_with_more_score": bool, // 투자 후 쇼핑을 시도할지 여부 (선택 가능, 기본값: false); 모드 1 에만 적용
|
||
"start_with_elite_two": bool, // 시작 리셋 시 엘리트2 등급 진급을 함께 시도할지 여부, 선택 가능, 기본값 false; 모드 4에만 해당
|
||
"only_start_with_elite_two": bool, // 엘리트2 등급 진급만 시도하고 다른 조건 무시 여부, 선택 가능, 기본값 false;
|
||
// 모드가 4이고 start_with_elite_two가 true일 때만 유효
|
||
"refresh_trader_with_dice": bool, // 주사위를 사용해 상점을 새로고침해 특정 상품 구매할지 여부, 선택 가능, 기본값 false; Mizuki 테마에만 해당, 지표 물고기 획득 목표
|
||
"first_floor_foldartal": string, // 1층 원견 단계에서 획득 희망하는 밀문, 선택 가능; Sami 테마에만 해당, 모드와 무관; 성공 시 작업 중지
|
||
"start_foldartal_list": [ // 시작 리셋 시 획득 희망 밀문 목록, 선택 가능, 기본값 []；Sami 테마에서 모드 4일 때만 유효;
|
||
string, // 시작 시 목록의 모든 밀문을 보유할 경우 시작 리셋 성공으로 간주;
|
||
... // 주의: 이 파라미터는 "생활 우선 부대"와 함께 사용해야 하며, 다른 부대에서는 시작 보상으로 밀문 획득 불가;
|
||
],
|
||
"collectible_mode_start_list": { // 시작 시 원하는 보상 항목 (선택 사항), 기본값은 모두 false; 모드 4에서만 유효
|
||
"hot_water": bool, // 보온병 보상, 물 끓이기 시스템 활성화에 사용됨 (공통)
|
||
"shield": bool, // 방어막 보상, 추가 체력과 동일 (공통)
|
||
"ingot": bool, // 원석 주괴 보상 (공통)
|
||
"hope": bool, // 희망 보상 (공통, 참고: JieGarden 테마에서는 제공되지 않음)
|
||
"random": bool, // 랜덤 보상 옵션: 모든 원석 주괴를 소모해 무작위 수집품 획득 (공통)
|
||
"key": bool, // 열쇠 보상, Mizuki 테마에서만 유효
|
||
"dice": bool, // 주사위 보상, Mizuki 테마에서만 유효
|
||
"ideas": bool, // 2개 구상 보상, Sarkaz 테마에서만 유효
|
||
},
|
||
"use_foldartal": bool, // 밀문 사용 여부, 모드 5에서는 기본값 false, 다른 모드에서는 기본값 true; Sami 테마에만 해당
|
||
"check_collapsal_paradigms": bool, // 획득한 붕괴 패러다임을 확인할지 여부, 모드 5에서는 기본값 true, 다른 모드에서는 기본값 false
|
||
"double_check_collapsal_paradigms": bool, // 붕괴 패러다임 확인 누락 방지 조치를 수행할지 여부, 모드 5에서는 기본값 true, 다른 모드에서는 기본값 false;
|
||
// 테마가 Sami이고 check_collapsal_paradigms가 true일 때만 유효
|
||
"expected_collapsal_paradigms": [ // 기대하는 붕괴 패러다임, 기본값 ["조금의 무시", "눈 감기", "이미지 손상", "새까맘"];
|
||
string, // 테마가 Sami이고 모드가 5일 때만 유효
|
||
...
|
||
]
|
||
}
|
||
```
|
||
|
||
- `Copilot`
|
||
Copilot 기반 자동 전투 기능
|
||
|
||
```json5
|
||
{
|
||
"enable": bool, // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
|
||
"filename": string, // 작업 JSON의 파일명과 경로, 절대/상대 경로를 지원합니다. 실행 중에 편집할 수 없습니다.
|
||
"formation": bool // "빠른 배치"을 할지 여부(ESC키 PAUSE 배치), 선택 사항, 기본값은 false입니다. 실행 중에 편집할 수 없습니다.
|
||
}
|
||
```
|
||
|
||
더 많은 자세한 정보는 [전투 스키마](./copilot-schema.md)를 참조하세요.
|
||
|
||
- `SSSCopilot`
|
||
보안파견용 AI 동반(Copilot 기반) 자동 전투 기능
|
||
|
||
```json5
|
||
{
|
||
"enable": bool, // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
|
||
"filename": string, // 작업 JSON의 파일명과 경로, 절대/상대 경로를 지원합니다. 실행 중에 편집할 수 없습니다.
|
||
"loop_times": int
|
||
}
|
||
```
|
||
|
||
더 많은 자세한 정보는 [보안파견 스키마](./sss-schema.md)를 참조하세요.
|
||
|
||
- `Depot`
|
||
창고 인식
|
||
|
||
```json5
|
||
// 해당 작업 매개변수
|
||
{
|
||
"enable": bool // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
|
||
}
|
||
```
|
||
|
||
- `OperBox`
|
||
오퍼레이터 보유 목록 인식 결과
|
||
|
||
```json5
|
||
// 해당 작업 매개변수
|
||
{
|
||
"enable": bool // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
|
||
}
|
||
```
|
||
|
||
- `Reclamation`
|
||
생명연산
|
||
|
||
```json5
|
||
{
|
||
"enable": bool,
|
||
"theme": string, // 테마, 선택사항, 기본값은 1입니다.
|
||
// Fire - *모래 속의 불꽃*
|
||
// Tales - *모래 안의 이야기*
|
||
"mode": int, // 모드,선택사항, 기본값은 0
|
||
// 0 - 점수를 획득하고 건설 점수를 얻어 전투에 진입한 후 바로 나가기
|
||
// 1 - *모래 속의 불꽃*: 황금을 얻기 위해 오퍼레이터가 물을 사고 기지를 강화합니다.
|
||
// *모래 안의 이야기*: 모래 안의 이야기: 자동으로 아이템을 제작하고 로드하여 통화를 획득
|
||
"tools_to_craft": [
|
||
string, // 자동으로 제작되는 아이템, 선택 사항, 기본값은 형광봉
|
||
...
|
||
]
|
||
// 부분 문자열을 채우는 것이 좋습니다
|
||
"increment_mode": int, // 클릭 유형, 선택 사항. 기본값은 0
|
||
// 0 - 연속 클릭
|
||
// 1 - 길게 누르기
|
||
"num_craft_batches": int // 한 번의 최대 제작 배치 수, 선택 사항. 기본값은 16
|
||
}
|
||
```
|
||
|
||
- `Custom`
|
||
|
||
사용자 정의 태스크
|
||
|
||
```json5
|
||
{
|
||
"enable": bool,
|
||
"task_names": [ // 배열에서 첫 번째 일치하는 항목부터 실행 (이후 next 등 순차적으로 진행)
|
||
// 여러 태스크를 수행하려면 Custom 태스크를 여러 번 추가할 수 있습니다.
|
||
string,
|
||
...
|
||
]
|
||
}
|
||
```
|
||
|
||
- `SingleStep`
|
||
|
||
단일 단계 태스크 (현재로서는 Copilot만 지원)
|
||
|
||
```json5
|
||
{
|
||
"enable": bool,
|
||
"type": string, // 현재로서는 "copilot"만 지원합니다.
|
||
"subtask": string, // "stage" | "start" | "action"
|
||
// "stage"는 단계 이름 설정 (예: "details": { "stage": "xxxx" })
|
||
// "start"는 미션 시작으로, 추가적인 세부사항 없이 시작합니다.
|
||
// "action"은 단일 전투 동작으로, 세부사항은 Copilot의 단일 동작입니다.
|
||
// 예시: "details": { "name": "史尔特尔", "location": [ 4, 5 ], "direction": "左" },자세한 내용은 전투 스키마 문서 참조
|
||
"details": {
|
||
...
|
||
}
|
||
}
|
||
```
|
||
|
||
- `VideoRecognition`
|
||
|
||
비디오 인식, 현재로서는 전투 비디오만 지원합니다.
|
||
|
||
```json5
|
||
{
|
||
"enable": bool,
|
||
"filename": string,
|
||
}
|
||
```
|
||
|
||
### `AsstSetTaskParams`
|
||
|
||
#### 프로토타입
|
||
|
||
```cpp
|
||
bool ASSTAPI AsstSetTaskParams(AsstHandle handle, TaskId id, const char* params);
|
||
```
|
||
|
||
#### 설명
|
||
|
||
태스크 매개변수 설정
|
||
|
||
#### 반환 값
|
||
|
||
- `bool`
|
||
매개변수가 성공적으로 설정되었는지 여부입니다.
|
||
|
||
#### 매개변수 설명
|
||
|
||
- `AsstHandle handle`
|
||
인스턴스 핸들
|
||
- `TaskId task`
|
||
태스크 ID, `AsstAppendTask`의 반환 값입니다.
|
||
- `const char* params`
|
||
JSON 형식의 태스크 매개변수, `AsstAppendTask`와 동일합니다.
|
||
"Editing in run-time is not supported"으로 표시되지 않은 필드는 실행 중에 변경할 수 있습니다. 그렇지 않으면 태스크가 실행 중일 때 이러한 변경 사항은 무시됩니다.
|
||
|
||
### `AsstSetStaticOption`
|
||
|
||
#### 프로토타입
|
||
|
||
```cpp
|
||
bool ASSTAPI AsstSetStaticOption(AsstStaticOptionKey key, const char* value);
|
||
```
|
||
|
||
#### 설명
|
||
|
||
프로세스 수준의 매개변수 설정
|
||
|
||
#### 반환 값
|
||
|
||
- `bool`
|
||
설정이 성공적인지 여부입니다.
|
||
|
||
#### 매개변수 설명
|
||
|
||
- `AsstStaticOptionKey key`
|
||
키
|
||
- `const char* value`
|
||
값
|
||
|
||
##### 키와 값 목록
|
||
|
||
없음
|
||
|
||
### `AsstSetInstanceOption`
|
||
|
||
#### 프로토타입
|
||
|
||
```cpp
|
||
bool ASSTAPI AsstSetInstanceOption(AsstHandle handle, AsstInstanceOptionKey key, const char* value);
|
||
```
|
||
|
||
#### 설명
|
||
|
||
인스턴스 수준의 매개변수 설정
|
||
|
||
#### 반환 값
|
||
|
||
- `bool`
|
||
설정이 성공적인지 여부입니다.
|
||
|
||
#### 매개변수 설명
|
||
|
||
- `AsstHandle handle`
|
||
핸들
|
||
- `AsstInstanceOptionKey key`
|
||
키
|
||
- `const char* value`
|
||
값
|
||
|
||
##### 키와 값 목록
|
||
|
||
```cpp
|
||
enum InstanceOptionKey
|
||
{
|
||
Invalid = 0,
|
||
// Deprecated // MinitouchEnabled = 1, // minitouch를 사용할 수 있는지 여부
|
||
// minitouch를 사용할 수 없는 경우에는 활성화되지 않습니다.
|
||
// "1" - 켬, "0" - 끔
|
||
TouchMode = 2, // 터치 모드, 기본적으로 minitouch
|
||
// minitouch | maatouch | adb
|
||
DeploymentWithPause = 3, // 일시정지 중에 배치 (로그라이크, Copilot 및 보안파견)
|
||
// "1" | "0"
|
||
AdbLiteEnabled = 4, // AdbLite를 활성화할지 여부, "0" | "1"
|
||
KillAdbOnExit = 5, // 종료 시 Adb 해제, "0" | "1"
|
||
};
|
||
```
|