차고 모드

차량에 유휴 시간을 제공하기 위해 차고 모드는 시스템을 절전 모드가 해제된 상태로 유지하여 유휴 상태로 제한된 JobScheduler의 작업을 실행할 수 있습니다.

차고 모드란?

스마트폰과 같이 연결된 기기에서 사용자는 시스템을 사용하여 기기가 안정적이고, 최신 상태이고, 최적화되어 있는지 확인합니다. 이러한 상태에 도달하기 위해 Android 플랫폼은 사용자가 기기와 상호작용하지 않을 때 애플리케이션이 작업을 실행할 수 있는 유휴 시간 기간을 제공합니다. 사용자가 스마트폰을 장시간(60분 이상) 터치하지 않고 화면이 꺼지면 스마트폰은 유휴 상태로 간주됩니다. 스마트폰과 달이 자동차를 사용하지 않을 때는 시동이 꺼집니다. 즉, 차량에는 유휴 시간 기간이 없습니다. 차고 모드는 자동차에서 유휴 시간을 보장합니다.

사용자가 자동차의 시동을 끄면 시스템이 차고 모드로 전환됩니다. 자동차가 차고 모드일 때는 시스템 전원이 켜져 있고, 디스플레이는 꺼져 있으며, JobScheduler 큐에 있는 유휴 작업이 실행됩니다. 차고 모드를 구현하려면 아래의 기기 구현 가이드라인을 참고하세요.

기기 구현 가이드라인

차고 모드를 활성화하려면 차량 시동을 끌 때 차량 HAL(VHAL)이 SHUTDOWN_PREPARE 상태를 사용하고 SHUTDOWN_ONLY 또는 CAN_SLEEP으로 설정된 매개변수를 사용하여 AP_POWER_STATE_REQ를 전송해야 합니다.

SHUTDOWN_PREPARE 상태가 유효하려면 VHAL이 AP_POWER_STATE_REQ 명령어에 두 매개변수(상태 및 추가 매개변수)를 지정해야 합니다. 그러면 기기가 차고 모드로 전환되어, JobScheduler에서 예약된 작업을 감지하고 작업이 완료될 때까지 시스템이 정지 또는 종료 상태로 전환되지 않도록 방지합니다.

기기 구현이 Android 프레임워크에 어떻게 연결되나요?

차고 모드의 경우 프레임워크는 필요한 지속 시간이 초과되거나 모든 작업이 실행될 때까지(이때가 되면 시스템은 종료됨) 시스템 종료 시간을 연장하도록 VHAL에 요청합니다. CDD에 정의된 특정 상황에서 기기 구현은 시스템을 더 빨리 종료할 수 있습니다. Android 호환성 요구사항에 관한 자세한 내용은 Android 호환성 정의 문서(CDD)를 참고하세요. 차고 모드가 완료되기 전에 VHAL이 시스템을 종료해야 하는 경우 VHAL은 SHUTDOWN_IMMEDIATELY 또는 SLEEP_IMMEDIATELY로 설정된 매개변수를 사용하여 SHUTDOWN_PREPARE를 실행할 수 있습니다. 기기 구현은 일반적으로 시스템을 계속 실행 상태로 유지하는 데 필요한 리소스를 사용할 수 없는 등의 특정 상황에 한해서만 이 매개변수를 사용할 수 있습니다. 예를 들어 배터리 용량이 부족한 경우가 해당됩니다.

차고 모드

애플리케이션 개발자는 차고 모드를 어떻게 사용하나요?

애플리케이션과 서비스는 차고 모드와 직접 상호작용하지 않습니다. 대신 앱은 JobScheduler에서 작업을 예약합니다. 유휴 상태로 제한된 작업은 차고 모드 중에 실행됩니다.

다음 코드는 차고 모드 중에 실행되도록 작업을 예약하는 방법을 보여 줍니다.

public class MyGarageModeJob extends JobService { ... }

Context context = ...;
int jobId = ...;

ComponentName myGarageModeJobName = new componentName(context,
                                                      MyGarageModeJob.class);

JobInfo.Builder infoBuilder = new JobInfo.Builder(jobId, myGarageModeJobName)
                    .setRequiresDeviceIdle(true);

// Example of an optional constraint:
infoBuilder.setRequiredNetworkType(NetworkType.NETWORK_TYPE_UNMETERED);

JobScheduler jobScheduler = (JobScheduler) context
                    .getSystemService(Context.JOB_SCHEDULER_SERVICE);

jobScheduler.schedule(infoBuilder.build());

차고 모드 디버깅

차고 모드를 디버그하려면 다음 단계를 따르세요.

차고 모드와 관련된 로깅 카테고리를 사용 설정하려면 다음과 같이 합니다.

adb shell stop
adb shell setprop log.tag.GarageMode VERBOSE
adb shell setprop log.tag.Finsky VERBOSE
adb shell setprop log.tag.CAR.POWER VERBOSE
adb shell setprop log.tag.JobScheduler.Connectivity VERBOSE
adb shell start

Logcat 출력을 검토하여 차고 모드가 시작되는지 확인합니다.

GarageMode: [Controller]: CPM state changed to SHUTDOWN_PREPARE
GarageMode: [GarageMode]: Entering GarageMode
GarageMode: [Controller]: Sending broadcast with action: com.android.server.jobscheduler.GARAGE_MODE_ON

차고 모드가 종료(취소 또는 완료)되었음을 나타내는 Logcat 출력을 확인합니다.
```
[GarageMode]: GarageMode was canceled
```
또는
```
[GarageMode]: GarageMode completed normally
```
차고 모드는 위에서 설명한 대로 차량의 전원 상태에 따라 다릅니다.

Logcat 출력을 검토하여 올바른 전원 상태가 입력되었는지 표시합니다.

CAR.POWER: starting shutdown prepare without Garage Mode
GarageMode: [Controller]: CPM state changed to SHUTDOWN_PREPARE
GarageMode: [GarageMode]: Entering GarageMode
CAR.POWER: send shutdown prepare
CAR.POWER: setPowerState=SHUTDOWN_PREPARE(7) param=0