멀티 윈도우 모드 지원

멀티 윈도우 모드를 사용하면 여러 앱이 같은 화면을 동시에 공유할 수 있습니다. 앱은 나란히 또는 상하로 배치 (화면 분할 모드)할 수 있으며, 다른 앱에 오버레이되는 작은 창 (PIP 모드) 또는 이동 및 크기 조절이 가능한 별도의 창에 있는 앱 (자유 형식 모드)

사용자 환경은 Android 버전과 기기 유형에 따라 다릅니다.

• Android 7.0 (API 수준 24)에서는 작은 화면의 화면 분할 모드를 도입했습니다. 및 일부 기기의 경우 PIP 모드입니다.

  • 화면 분할 모드는 화면을 두 개의 앱으로 채우며 표시합니다. 나란히 또는 상하로 배치합니다 사용자가 구분선을 드래그할 수 있음 하나의 앱을 다른 앱보다 크게 만들기 위해 두 앱을 분리하는 과정입니다.

  • PIP 모드를 사용하면 사용자가 동영상을 계속 재생할 수 있습니다. 여러 번 시도해 보세요 (PIP 모드 지원 참고).

  • 자유 형식 모드는 사용자가 각 활동의 크기를 자유롭게 조정할 수 있으며, 대형 화면 기기 제조업체에서 사용 설정해야 합니다.

    다음을 지정하여 앱이 멀티 윈도우 모드를 처리하는 방식을 구성할 수 있습니다. 최소 허용 크기를 지정합니다. 또한 앱에 멀티 윈도우 모드를 설정하는 방법은 다음과 같습니다. 시스템에서 항상 표시되도록 resizeabableActivity="false" 전체 화면으로 전환할 수 있습니다.

• Android 8.0 (API 수준 26)은 PIP 모드를 작게 확장 화면 기기

• Android 12 (API 수준 31)는 멀티 윈도우 모드를 표준 동작으로 지정합니다.

  • 대형 화면 (중형 또는 확장 창 크기 클래스)의 경우 플랫폼이 앱과 상관없이 멀티 윈도우 모드의 모든 앱을 지원함 구성할 수 있습니다 resizeableActivity="false"인 경우 앱이 디스플레이 크기를 수용하기 위해 필요한 경우 호환성 모드를 사용합니다.

  • 작은 화면 (소형 창 크기 클래스)에서는 시스템이 활동의 minWidth 및 minHeight를 활용하여 멀티 윈도우 모드에서 실행할 수 있습니다. 만약 resizeableActivity="false": 앱이 다음에서 실행되지 않습니다. 멀티 윈도우 모드로 작동합니다.

  를 통해 개인정보처리방침을 정의할 수 있습니다.

화면 분할 모드

사용자는 다음을 수행하여 화면 분할 모드를 활성화할 수 있습니다.

1. 최근 화면을 엽니다.
2. 앱을 스와이프하여 뷰로 가져옵니다.
3. 앱 제목 표시줄에서 앱 아이콘을 누릅니다.
4. 화면 분할 메뉴 옵션을 선택합니다.
5. 최근 화면에서 다른 앱을 선택하거나 최근 화면을 닫고 다른 앱 실행

사용자는 창 구분선을 화면 가장자리(예: 위 또는 아래, 왼쪽 또는 오른쪽)로 드래그하여 화면 분할 모드를 종료할 수 있습니다.

인접 항목 실행

앱이 인텐트를 통해 콘텐츠에 액세스해야 하는 경우 다음을 사용할 수 있습니다. FLAG_ACTIVITY_LAUNCH_ADJACENT 화면 분할 창을 엽니다.

FLAG_ACTIVITY_LAUNCH_ADJACENT는 Android 7.0 (API 수준 24)에서 도입되어 화면 분할 모드로 실행 중인 앱이 인접한 창

Android 12L (API 수준 32) 이상에서는 플래그 정의를 전체 화면을 실행하는 앱이 화면 분할 모드를 활성화하도록 설정한 다음 인접한 창에 있는 활동.

인접 활동을 실행하려면 다음에서 FLAG_ACTIVITY_LAUNCH_ADJACENT를 사용합니다. FLAG_ACTIVITY_NEW_TASK와 결합. 예를 들면 다음과 같습니다.

fun openUrlInAdjacentWindow(url:
String) { Intent(Intent.ACTION_VIEW).apply { data = Uri.parse(url)
addFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT or Intent.FLAG_ACTIVITY_NEW_TASK)
 }.also { intent -> startActivity(intent) } }

public void openUrlInAdjacentWindow(String url) {
  Intent intent = new Intent(Intent.ACTION_VIEW);
  intent.setData(Uri.parse(url));
  intent.addFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT | Intent.FLAG_ACTIVITY_NEW_TASK);
  startActivity(intent);
}

멀티 윈도우 모드의 활동 수명 주기

멀티 윈도우 모드는 활동 수명 주기를 변경하지 않습니다. 그러나 여러 창에서 앱의 재개 상태는 앱의 여러 버전에 따라 Android

다중 재개

Android 10 (API 수준 29) 이상 버전은 다중 재개를 지원합니다. 모두 기기가 멀티 윈도우에 있을 때 활동이 RESUMED 상태로 유지됨 있습니다. 투명한 활동이 활동에 포커스를 둘 수 없는 경우(예: 활동이 PIP 모드입니다. 또한 포드에서 실행 중인 포드에 포커스가 있는 예를 들어 알림 창이 열려 있는 경우 onStop() 메서드는 평소와 같이 작동합니다. 이 메서드는 활동이 종료될 때마다 호출됩니다. 화면

다중 재개는 Android 9 (API 수준)을 실행하는 일부 기기에서도 사용할 수 있습니다. 참조). Android 9 기기에서 다중 재개하도록 선택하려면 다음 매니페스트를 추가합니다. 메타데이터:

<meta-data android:name="android.allow_multiple_resumed_activities" android:value="true" />

지정된 기기가 이 매니페스트 메타데이터를 지원하는지 확인하려면 기기 사양을 참고하세요.

Android 9

Android 9(API 수준 28) 이하의 멀티 윈도우 모드에서는 사용자가 최근에 상호작용했던 활동만 지정된 시간에 활성 상태가 됩니다. 이 활동이 최상위로 간주되며 RESUMED의 유일한 활동이 됩니다. 있습니다. 그 외에 표시되는 모든 활동은 STARTED이지만 RESUMED는 아닙니다. 그러나 시스템은 이러한 표시 가능하지만 재개되지 않은 활동을 더 높게 우선순위가 높은 경우에만 사용할 수 있습니다 사용자가 해당 활동이 재개되며 이전에 최상위에 있던 활동이 STARTED 상태로 전환됩니다.

단일 활성 앱 프로세스 내에 여러 활동이 있는 경우 z 순서가 가장 높은 활동이 재개되고 나머지는 일시중지됩니다.

구성 변경

사용자가 앱을 멀티 윈도우 모드에 놓으면 시스템은 구성 처리 변경사항을 참조하세요. 이는 사용자가 앱의 크기를 조절하거나 앱을 다시 배치하는 경우에도 발생합니다. 전체 화면 모드로 전환할 수 있습니다.

기본적으로 이 변경은 이전 버전과 같은 활동 수명 주기에 영향을 미칩니다. 기기가 세로 모드에서 세로 모드로 전환되었다고 앱에 알립니다. 가로 방향입니다. 단, 화면 방향이 바뀌는 대신 앱 크기가 교체되는 것이 일반적입니다. Activity가 구성 변경을 자체적으로 처리할 수 있습니다. 앱은 시스템이 활동을 소멸시키고 새 측정기준을 만들 수 있습니다.

사용자가 창의 크기를 조정하여 한쪽 치수를 더 크게 만드는 경우, 시스템은 사용자 작업에 맞게 활동의 크기를 조정하고 필요한 경우 구성 변경을 수행합니다. 앱이 새로 노출된 영역에 그림을 그릴 때 지연이 발생하는 경우 시스템이 지정한 색으로 해당 영역을 임시로 windowBackground 속성 또는 기본값 windowBackgroundFallback 스타일 속성

독점적 리소스 액세스

다중 재개 기능을 지원하려면 onTopResumedActivityChanged() 수명 주기 콜백입니다.

콜백은 활동이 최상위 재개 활동을 얻거나 잃을 때 호출됩니다. 위치(활동이 공유 싱글톤 리소스를 사용할 때 중요함) 예:

override fun
onTopResumedActivityChanged(topResumed: Boolean) { if (topResumed) { // Top
resumed activity. // Can be a signal to re-acquire exclusive resources. } else {
// No longer the top resumed activity. } }

@Override
public void onTopResumedActivityChanged(boolean topResumed) {
  if (topResumed) {
      // Top resumed activity.
      // Can be a signal to re-acquire exclusive resources.
  } else {
      // No longer the top resumed activity.
  }
}

공유 하드웨어 제거와 같은 여러 다른 이유로 앱에서 리소스가 손실될 수 있습니다.

어떤 경우이든 앱은 사용 가능한 리소스에 영향을 주는 이벤트 및 상태 변경을 적절하게 처리해야 합니다.

카메라를 사용하는 앱의 경우 CameraManager.AvailabilityCallback#onCameraAccessPrioritiesChanged() 드림 카메라에 액세스해볼 수 있는 적절한 때를 알려주는 힌트를 제공합니다. 이 메서드는 Android 10(API 수준 29)부터 사용할 수 있습니다.

resizeableActivity=false는 전용 카메라를 보장하지 않습니다. 카메라를 사용하는 다른 앱을 다른 디스플레이에서 열 수 있기 때문입니다.

앱이 포커스를 잃을 때 카메라를 해제할 필요는 없습니다. 예를 들어 사용자가 상호작용하는 동안에도 카메라 미리보기를 계속하고 싶을 수 있습니다. 할 수 있습니다. 앱이 최상위 재개 앱이 아닌 경우 카메라를 실행하지만 연결 해제 케이스를 제대로 분리합니다. 최상위 재개 앱이 카메라가 열 수 있고 앱에서 액세스할 수 없게 됩니다. 앱에서 카메라에 다시 액세스할 수 있습니다.

앱이 CameraDevice.StateCallback#onDisconnected()를 수신한 후 카메라 기기에서 후속 호출을 실행하면 CameraAccessException

다중 디스플레이

Android 10(API 수준 29)은 보조 디스플레이에서의 활동을 지원합니다. 다중 디스플레이를 사용하는 기기에서 활동을 실행하는 경우 사용자는 하나의 디스플레이에서 다른 디스플레이로 활동을 이동할 수 있습니다. 다중 재개가 적용되는 항목 멀티스크린 시나리오도 지원합니다. 사용자 입력을 수신할 수 있는 할 수 있습니다.

앱은 실행될 때 또는 다른 활동을 만들 때 실행할 디스플레이를 지정할 수 있습니다. 이 동작은 매니페스트 파일에 정의된 활동 시작 모드와 활동을 실행하는 항목에 설정된 인텐트 플래그 및 옵션에 따라 달라집니다. 자세한 내용은 ActivityOptions 클래스를 참고하세요. 확인하세요.

활동이 보조 디스플레이로 이동하는 경우 컨텍스트 업데이트, 창 크기 조절, 구성 및 리소스 변경을 실행할 수 있습니다. 활동이 구성 변경을 처리할 때 활동은 onConfigurationChanged() 그러지 않으면 활동이 다시 시작됩니다.

활동은 onCreate()의 현재 디스플레이를 확인해야 합니다. 구성 변경을 처리하는 경우 onConfigurationChanged()입니다. 디스플레이가 변경되면 리소스 및 레이아웃도 업데이트되어야 합니다.

활동에 대해 선택된 시작 모드가 여러 인스턴스를 허용하는 경우 활동의 새 인스턴스를 생성할 수 있습니다. 두 활동 모두 재개됩니다.

</ph> <ph type="x-smartling-placeholder">

또한 Google Cloud에서 소개된 다중 디스플레이 API 지원한다는 것입니다.

활동 및 애플리케이션 컨텍스트 비교

다중 디스플레이에서는 올바른 컨텍스트를 사용하는 것이 매우 중요합니다. 리소스에 액세스하는 경우 활동 컨텍스트(표시됨)와 애플리케이션 컨텍스트(표시되지 않음)가 서로 다릅니다.

활동 컨텍스트는 디스플레이 정보를 포함하며 활동이 표시되는 디스플레이 영역에 맞게 항상 조정됩니다. 이를 통해 화면의 디스플레이 밀도 또는 창 측정항목에 대한 올바른 정보를 있습니다. 항상 활동 컨텍스트 (또는 다른 UI 기반 컨텍스트)를 사용하여 현재 창 또는 디스플레이에 관한 정보를 가져옵니다. 또한 컨텍스트의 정보를 사용하는 일부 시스템 API에 영향을 미칩니다 (예: 토스트 메시지 개요).

활동 창 구성 및 상위 디스플레이는 리소스 및 컨텍스트를 정의합니다. 다음과 같이 현재 디스플레이를 가져옵니다.

val activityDisplay = activity.getDisplay()

Display activityDisplay = activity.getDisplay();

현재 활동 창 측정항목을 가져옵니다.

val windowMetrics = activity.getWindowManager().getCurrentWindowMetrics()

WindowMetrics windowMetrics = activity.getWindowManager().getCurrentWindowMetrics();

현재 시스템 구성의 최대 창 측정항목을 가져옵니다.

val maximumWindowMetrics = activity.getWindowManager().getMaximumWindowMetrics()

WindowMetrics maximumWindowMetrics = activity.getWindowManager().getMaximumWindowMetrics();

최대 창 측정항목은 계산하거나 레이아웃을 선택하거나 미리 가져올 리소스의 크기를 결정하는 데 사용됩니다. onCreate()에서 이 측정항목을 사용할 수 있으면 첫 번째 레이아웃 전달 전에 그러한 결정을 내릴 수 있습니다. 이러한 측정항목은 특정 뷰 요소를 배치하는 데 사용하면 안 됩니다. 대신 Configuration 객체의 정보를 사용하세요.

디스플레이 컷아웃

폴더블 기기가 접혔을 때와 펼쳐졌을 때 컷아웃 도형이 다를 수 있습니다. 컷아웃 문제를 방지하려면 디스플레이 컷아웃 지원을 참고하세요.

보조 디스플레이

DisplayManager 시스템 서비스에서 사용 가능한 디스플레이를 가져올 수 있습니다.

val displayManager =
getSystemService(Context.DISPLAY_SERVICE) as DisplayManager val displays =
displayManager.getDisplays()

DisplayManager displayManager = (DisplayManager) getSystemService(Context.DISPLAY_SERVICE);
Display[] displays = displayManager.getDisplays();

Display 클래스를 사용하여 다음과 같은 특정 디스플레이에 관한 정보를 가져옵니다. 를 디스플레이 크기 또는 디스플레이가 안전한지 나타내는 플래그로 사용합니다. 하지만 디스플레이 크기가 표시됩니다. 멀티 윈도우 모드에서는 디스플레이의 일부를 차지합니다.

디스플레이에서 활동을 실행할 수 있는지 확인합니다.

val activityManager =
getSystemService(Context.ACTIVITY_SERVICE) as ActivityManager val
activityAllowed = activityManager.isActivityStartAllowedOnDisplay(context,
displayId, intent)

ActivityManager activityManager = (ActivityManager) getSystemService(Context.ACTIVITY_SERVICE);
boolean activityAllowed = activityManager.isActivityStartAllowedOnDisplay(context, displayId, intent);

그런 다음 디스플레이에서 활동을 시작합니다.

val options = ActivityOptions.makeBasic()
options.setLaunchDisplayId(targetDisplay.displayId) startActivity(intent,
options.toBundle())

ActivityOptions options = ActivityOptions.makeBasic();
options.setLaunchDisplayId(targetDisplay.displayId);
startActivity(intent, options.toBundle());

다중 디스플레이 지원

Android는 소프트웨어 키보드, 배경화면 및 런처에 다중 디스플레이 지원을 제공합니다.

소프트웨어 키보드

디스플레이가 시스템 데코레이션을 지원하도록 구성된 경우 키보드를 보조 화면에 표시할 수 있습니다. 디스플레이에서 텍스트 입력란이 입력을 요청하는 경우 자동으로 입력 방식 편집기(IME)가 표시됩니다.

배경화면

Android 10(API 수준 29)에서 보조 화면에 배경화면이 포함될 수 있습니다. 이 프레임워크는 각각에 대해 별도의 WallpaperService.Engine 인스턴스를 만듭니다. 디스플레이. 각 엔진의 표면이 독립적으로 그려지도록 해야 합니다. 개발자 표시 컨텍스트를 사용하여 애셋을 WallpaperService.Engine#getDisplayContext() 또한 WallpaperInfo.xml 파일이 android:supportsMultipleDisplays="true"를 설정합니다.

런처

새로운 인텐트 필터 카테고리인 SECONDARY_HOME은 보조 화면에 전용 활동을 제공합니다. 활동의 인스턴스는 디스플레이마다 하나씩 시스템 데코레이션을 지원하는 모든 디스플레이에서 사용됩니다.

<activity>
    ...
    <intent-filter>
        <category android:name="android.intent.category.SECONDARY_HOME" />
        ...
    </intent-filter>
</activity>

활동에는 다중 인스턴스를 방지하지 않고 다양한 화면 크기에 맞게 조정할 수 있는 시작 모드가 있어야 합니다. 시작 모드는 singleInstance 또는 singleTask가 될 수 없습니다.

예를 들어 Launcher3의 AOSP 구현은 다음을 지원합니다. SECONDARY_HOME 활동.

를 통해 개인정보처리방침을 정의할 수 있습니다.

</ph> <ph type="x-smartling-placeholder">

창 측정항목

Android 11 (API 수준 30)에는 다음 WindowManager 메서드가 도입되었습니다. 를 사용하여 멀티 윈도우 모드에서 실행되는 앱의 경계를 제공합니다.

• getCurrentWindowMetrics(): 다음에 대한 WindowMetrics 객체를 반환합니다. 시스템의 현재 윈도잉 상태입니다.
• getMaximumWindowMetrics(): 가장 큰 값의 WindowMetrics을 반환합니다. 시스템의 잠재적 윈도잉 상태에 영향을 줍니다.

Jetpack WindowManager 라이브러리 메서드 computeCurrentWindowMetrics() 및 computeMaximumWindowMetrics()는 유사한 기능을 제공합니다. API 수준 14와 하위 호환성이 있습니다.

현재 디스플레이 이외의 디스플레이에 관한 측정항목을 가져오려면 다음 단계를 따르세요. (코드 스니펫에 표시된 대로)입니다.

• 디스플레이 컨텍스트를 만듭니다.
• 디스플레이의 창 컨텍스트를 만듭니다.
• 창 컨텍스트의 WindowManager를 가져옵니다.
• 앱에서 사용할 수 있는 최대 디스플레이 영역의 WindowMetrics를 가져옵니다.

val windowMetrics =
context.createDisplayContext(display)
.createWindowContext(WindowManager.LayoutParams.TYPE_APPLICATION, null)
.getSystemService(WindowManager::class.java) .maximumWindowMetrics

WindowMetrics windowMetrics = context.createDisplayContext(display)
                            .createWindowContext(WindowManager.LayoutParams.TYPE_APPLICATION, null)
                            .getSystemService(WindowManager.class)
                            .getMaximumWindowMetrics();

지원 중단된 메서드

Display 메서드 getSize() 및 getMetrics()는 다음에서 지원 중단되었습니다. API 수준 30(새로운 WindowManager 메서드로 대체)

Android 12 (API 수준 31)에서는 Display 메서드 getRealSize()가 지원 중단됩니다. getRealMetrics()을(를) 검색하고, 공격의 행동을 getMaximumWindowMetrics()의 동작

멀티 윈도우 모드 구성

앱이 Android 7.0 (API 수준 24) 이상을 타겟팅하는 경우 앱의 활동이 멀티 윈도우 모드를 지원하는지가 포함될 수 있습니다. 다음과 같이 설정할 수 있습니다. 속성을 사용하여 크기와 레이아웃을 제어할 수 있습니다. 루트 활동의 속성 설정은 작업 스택 내의 모든 활동에 적용됩니다. 예를 들어 루트 활동에 android:resizeableActivity="true"가 있으면 활동의 크기를 조절할 수 있습니다. 다음과 같은 일부 대형 기기에서 Chromebook의 경우에는 android:resizeableActivity="false" 이로 인해 앱이 중단되면 Google Play의 필터를 사용하여 이러한 기기에서 앱의 사용 가능 여부를 제한해야 합니다.

Android 12 (API 수준 31)는 기본적으로 멀티 윈도우 모드로 설정되어 있습니다. 대형 화면 (중형 또는 확장 창 크기 클래스), 모든 앱이 멀티 윈도우에서 실행됨 앱 구성과 관계없이 실행됩니다. 작은 화면에서는 시스템이 활동의 minWidth, minHeight, resizeableActivity 설정을 사용하여 활동을 멀티 윈도우 모드에서 실행할 수 있는지 여부를 결정합니다.

resizeableActivity

매니페스트의 <activity> 또는 <application>에서 이 속성을 설정합니다. 요소를 사용하여 API 수준 30 이하에서 멀티 윈도우 모드를 활성화 또는 비활성화할 수 있습니다.

<application
  android:name=".MyActivity"
  android:resizeableActivity=["true" | "false"] />;

이 속성을 true로 설정하면 활동을 화면 분할로 실행할 수 있습니다. 자유형 모드입니다 속성을 false로 설정하면 활동은 멀티 윈도우 모드를 지원합니다. 값이 false이고 사용자가 활동을 멀티 윈도우 모드에서 시작하면 활동이 전체 화면

앱이 API 수준 24 이상을 타겟팅하지만 이 속성을 사용하면 속성의 기본값은 true가 됩니다.

앱이 API 수준 31 이상을 타겟팅하는 경우 이 속성은 작은 화면과 큰 화면:

• 대형 화면 (중형 또는 확장 창 크기 클래스): 모든 앱 멀티 윈도우 모드를 지원합니다. 이 속성은 활동이 크기가 조정됩니다 resizeableActivity="false"인 경우 앱이 디스플레이 크기를 준수하기 위해 필요한 경우 호환성 모드를 사용합니다.
• 작은 화면 (소형 창 크기 클래스): resizeableActivity="true" 및 활동 최소 너비 및 최소 높이 멀티 윈도우 요구사항 내에 있다면 활동이 멀티 윈도우를 지원하는 경우 있습니다. resizeableActivity="false"인 경우 활동이 멀티 윈도우 모드로 전환할 수 있습니다.

supportsPictureInPicture

매니페스트의 <activity> 노드에서 이 속성을 설정하여 활동이 PIP 모드를 지원합니다.

<activity
  android:name=".MyActivity"
  android:supportsPictureInPicture=["true" | "false"] />

configChanges

멀티 윈도우 구성 변경을 직접 처리하려는 경우(예: 사용자가 창 크기를 조절하려면 앱에 android:configChanges 속성을 추가하세요. 매니페스트 <activity> 노드를 포함해야 합니다.

<activity
  android:name=".MyActivity"
  android:configChanges="screenSize | smallestScreenSize
      | screenLayout | orientation" />

android:configChanges를 추가하면 활동과 프래그먼트에서 onConfigurationChanged()의 콜백이 소멸되는 대신 있습니다. 그런 다음 뷰를 수동으로 업데이트하고 리소스를 새로고침하며 다른 작업을 수행할 수 있습니다

<layout>

Android 7.0 (API 수준 24) 이상에서는 <layout> 매니페스트 요소 멀티 윈도우에서 활동이 동작하는 방식에 영향을 미치는 여러 속성을 지원 모드:

• android:defaultHeight, android:defaultWidth: 다음의 기본 높이와 너비: .

• android:gravity: 다음에서 시작될 때 활동의 초기 배치 자유형 모드입니다. 적합한 값은 Gravity 클래스를 참고하세요.

• android:minHeight, android:minWidth: 최소 높이 및 최소 너비 를 사용합니다. 사용자가 이사하는 경우 활동을 원래 크기로 분할하여 지정된 최솟값이 있는 경우, 시스템은 활동을 사용자의 요청을 처리합니다

다음 코드에는 활동이 자유 형식 모드로 표시될 때 이 활동의 기본 크기와 위치 및 최소 크기를 지정하는 방법이 나와 있습니다.

<activity android:name=".MyActivity">
    <layout android:defaultHeight="500dp"
          android:defaultWidth="600dp"
          android:gravity="top|end|..."
          android:minHeight="450dp"
          android:minWidth="300dp" />
</activity>

런타임에 멀티 윈도우 모드

Android 7.0부터 시스템은 멀티 윈도우 모드에서 실행할 수 있습니다.

멀티 윈도우 모드에서 중지되는 기능

멀티 윈도우 모드에서 Android는 기기 화면을 다른 활동이나 앱과 공유하는 활동에 적용되지 않는 기능을 사용 중지하거나 무시할 수 있습니다.

또한 일부 시스템 UI 맞춤설정 옵션이 사용 중지됩니다. 예를 들어 앱은 멀티 윈도우 모드에서 실행되는 경우 상태 표시줄을 숨길 수 없습니다 (자세한 내용은 시스템 UI 공개 상태 제어).

시스템에서 android:screenOrientation 속성 변경사항을 무시합니다.

멀티 윈도우 모드 쿼리 및 콜백

Activity 클래스는 멀티 윈도우를 지원하는 다음 메서드를 제공합니다. 모드:

• isInMultiWindowMode(): 활동이 다음에 있는지를 나타냅니다. 멀티 윈도우 모드를 지원합니다.

• isInPictureInPictureMode(): 활동이 다음에 있는지를 나타냅니다. PIP 모드입니다.

• onMultiWindowModeChanged(): 멀티 윈도우 모드로 들어가거나 이 모드에서 나올 때. 시스템은 활동이 멀티 윈도우 모드로 들어갈 때는 true이고, 아니면 false입니다. 활동이 멀티 윈도우 모드를 종료합니다.

• onPictureInPictureModeChanged(): 시스템에서 언제든지 이 메서드를 호출합니다. 활동이 PIP 모드로 들어가거나 이 모드에서 나올 때. 시스템은 메서드가 활동이 PIP 모드로 진입하는 경우 true 값 모드가 PIP 모드이거나 활동이 PIP 모드에서 나가면 false입니다.

Fragment 클래스는 위와 같은 여러 메서드의 버전을 노출합니다. 예를 들어 Fragment.onMultiWindowModeChanged()

PIP 모드

활동을 PIP 모드에 두려면 다음을 호출합니다. enterPictureInPictureMode() 기기가 기기에 영향을 미치면 이 메서드는 효과가 없습니다. PIP 모드를 지원하지 않습니다. 자세한 내용은 다음을 사용하여 동영상 추가 PIP 모드를 사용합니다.

멀티 윈도우 모드에서 새 활동

새 활동을 시작하는 경우 새 활동이 시작되어야 한다고 나타낼 수 있습니다. 가능한 경우 현재 프레임에 인접하여 표시됩니다. 인텐트 플래그 사용 FLAG_ACTIVITY_LAUNCH_ADJACENT: 시스템에 새 활동이 있는 경우 이 두 활동이 화면을 공유합니다. 이 이를 위해 최선을 다하지만 반드시 실행되리라는 보장은 없습니다.

기기가 자유 형식 모드에 있고 새 활동을 시작하는 경우 다음을 호출하여 새 액티비티의 크기와 화면 위치를 지정합니다. ActivityOptions.setLaunchBounds() 기기가 멀티 윈도우 모드에 있지 않아야 합니다.

API 수준 30 이하에서는 작업 스택 내에서 활동을 실행하면 활동은 화면의 활동을 대체하여 모든 멀티 윈도우를 상속함 속성 새 활동을 사용하는 경우 새 작업 스택에서 실행해야 합니다.

Android 12(API 수준 31)에서는 앱이 여러 활동 간에 애플리케이션의 작업 창을 분할할 수 있습니다. 앱이 전체 화면, 나란히 또는 스택 등 여러 활동에 대한 XML을 생성하여 Jetpack WindowManager API를 호출할 수 있습니다.

드래그 앤 드롭

사용자는 두 활동이 화면을 공유하는 동안 한 활동에서 다른 활동으로 데이터를 드래그 앤 드롭할 수 있습니다. (Android 7.0 이전에는 사용자가 단일 활동 내에서 데이터를 삭제할 수 있습니다.) 수락에 대한 지원을 빠르게 추가하기 위해 DropHelper API가 표시됩니다. 포괄적인 드래그 앤 드롭 기능 드래그 앤 드롭 사용 설정을 참고하세요.

멀티 인스턴스

각 루트 활동에는 별도의 프로세스에서 실행되며 자체 창에 표시되는 자체 작업이 있습니다. 별도의 창에서 앱의 새 인스턴스를 시작하려면 FLAG_ACTIVITY_NEW_TASK 플래그를 사용하여 새 활동을 시작하면 됩니다. 나 이를 멀티 윈도우 속성과 결합하여 새 창의 특정 위치를 지정합니다. 예를 들어, 쇼핑 앱은 여러 개의 창을 표시하여 제품을 비교할 수 있습니다.

Android 12 (API 수준 31)에서는 활동의 두 인스턴스를 실행할 수 있습니다. 같은 작업 창에 나란히 표시할 수 있습니다.

사용자가 애플리케이션의 다른 인스턴스를 시작할 수 있도록 하려면 실행하려는 경우 런처 활동이 실행되고 있는지 확인하세요. android:resizeableActivity="true"를 설정하고 여러 인스턴스를 방지합니다 예를 들어 singleInstancePerTask 활동은 여러 번 인스턴스화될 수 있습니다 FLAG_ACTIVITY_MULTIPLE_TASK 또는 FLAG_ACTIVITY_NEW_DOCUMENT가 설정되어 있습니다.

멀티 인스턴스를 멀티 패널 레이아웃(예: list-detail)과 혼동하지 마세요. 단일 내에서 실행되는 SlidingPaneLayout를 사용하는 프레젠테이션 창

폴더블 기기에서 여러 인스턴스가 별도의 창에서 실행 중인 경우 상태가 변경되면 하나 이상의 인스턴스가 백그라운드로 전송될 수 있습니다. 예를 들어, 기기가 펼쳐져 있고 폴드의 양쪽에서 각각 창 하나당 앱 인스턴스 하나가 실행 중이라면 이 기기를 접을 경우 두 인스턴스의 창을 작은 화면에 맞추려고 시도하는 대신 인스턴스 중 하나가 종료될 수 있습니다.

멀티 윈도우 모드 확인

앱이 API 수준 24 이상을 타겟팅하는지 여부와 관계없이 어떻게 해야 하는지를 확인해야 합니다. 사용자가 멀티 윈도우에서 실행하려고 하면 멀티 윈도우 모드에서 동작함 Android 7.0 이상을 실행하는 기기에서 실행할 수 있습니다.

테스트 기기

Android 7.0(API 수준 24) 이상을 실행하는 기기는 멀티 윈도우 모드를 지원합니다.

API 수준 23 이하

사용자가 앱을 멀티 윈도우 모드에서 사용하려고 시도하는 경우, 이 앱이 고정 방향을 선언하지 않으면 시스템이 앱의 크기를 강제로 조정합니다.

앱이 고정 방향을 선언하지 않는 경우 Android 7.0 이상을 실행하는 기기에서 화면 분할 모드로 전환할 수 있습니다. 앱이 지원될 때 사용자 환경이 적절한지 확인 강제로 크기가 조절되었습니다.

앱이 고정 방향을 선언하는 경우, 앱을 멀티 윈도우 모드에 두도록 해야 합니다. 이때 앱이 전체 화면 모드 상태에 있는지 확인하세요.

API 수준 24~30

앱이 API 수준 24~30을 타겟팅하고 멀티 윈도우 지원을 중지하지 않는 경우, 화면 분할 모드에서는 물론 자유 형식 모드에서도 다음 동작을 확인하세요.

• 앱을 전체 화면 모드로 시작한 후, 다음과 같은 방법으로 멀티 윈도우 모드로 전환합니다. 최근 버튼을 길게 누릅니다. 앱이 적절히 전환되는지 확인합니다.

• 앱을 멀티 윈도우 모드에서 직접 실행하고 앱이 실행됩니다. 멀티 윈도우 모드에서 앱을 시작하려면 최근 버튼을 누른 다음 앱의 제목 표시줄을 길게 누르고 아이콘을 화면의 강조표시된 영역 중 하나로 드래그합니다.

• 화면 분할선을 드래그하여 화면 분할 모드에서 앱의 크기를 조정합니다. 확인 비정상 종료 없이 앱 크기가 조정되고 필요한 UI 요소가 표시됩니다.

• 앱에 최소 치수를 지정한 경우, 앱의 창 크기를 이 크기보다 작게 만듭니다. 다음을 확인합니다. 지정된 최솟값보다 더 작게 앱 크기를 조절할 수 없습니다. 측정기준에 따라 달라집니다.

• 모든 테스트를 통해 앱의 성능이 적절한지 확인합니다. 대상 예를 들어, 앱의 크기가 조정됩니다

API 수준 31 이상

앱이 API 수준 31 이상 및 기본 활동의 최소 너비를 타겟팅하는 경우 최소 높이는 표시 영역에서 API 수준 24에 나열된 모든 동작을 확인 30초까지 가능합니다.

테스트 체크리스트

멀티 윈도우 모드에서 앱의 성능을 확인하려면, 다음 작업을 시도해 보세요. 별다른 설명이 없다면 화면 분할 및 자유 형식 모드에서 모두 이 작업을 시도해야 합니다.

• 다중 창 모드에 들어갔다 나옵니다.

• 사용 중인 앱에서 다른 앱으로 전환하고 앱이 작동하는지 확인 광고가 표시되지만 활성화되지 않은 상태에서는 올바르게 작동하지 않을 수 있습니다. 예를 들어 앱이 사용자가 동영상을 재생 중인 동안 동영상이 계속 재생되는지 확인합니다. 다른 앱과의 상호작용입니다.

• 화면 분할 모드에서 화면 분할선을 이동하여 앱이 두 화면과 큰 도움이 됩니다. 나란히 또는 위에서 하나씩 다음 작업을 시도해 봅니다. 다른 구성을 사용할 수 있습니다 앱이 비정상 종료되지 않는지 확인(필수) 기능이 표시되고 크기 조절 작업에 오래 걸리지 않습니다.

• 빠르게 연속해서 여러 가지 크기 조정 작업을 수행합니다. 앱 확인 비정상 종료되거나 메모리가 누수되지 않습니다. Android 스튜디오의 메모리 프로파일러는 앱의 메모리 사용량에 대한 정보를 제공합니다 (앱의 메모리 검사는 메모리 프로파일러의 사용량)을 참고하세요.

• 다양한 창 구성에서 앱을 정상적으로 사용합니다. 확인해야 합니다. 텍스트를 읽을 수 있고 UI 요소는 상호작용하기에 그다지 작지 않습니다.

멀티 윈도우 지원 사용 중지됨

API 수준 24~30에서 android:resizeableActivity="false"님, 기기에서 앱을 실행해야 합니다 앱을 화면 분할 모드로 전환한 다음 자유형 모드입니다. 이때 앱이 전체 화면에 계속 표시되는지 확인하세요. 있습니다.

추가 리소스

Android의 멀티 윈도우 지원에 관한 자세한 내용은 다음을 참고하세요.

• Android MultiWindowPlayground 샘플