2022년 11월, Android용 ARCore SDK (Kotlin/자바)의 카메라 메서드 삭제가 지원 중단됨

2022년 11월, Google Play AR 서비스에서는 NDK 카메라 이미지 및 메타데이터와 관련하여 지원 중단된 메서드를 삭제합니다.

영향을 받는 버전의 ARCore SDK에서 이러한 메서드를 사용하는 앱은 사용자가 Google Play AR 서비스를 업데이트할 때 다르게 동작하거나 비정상 종료될 수 있습니다.

영향을 받은 앱

2022년 11월부터 다음과 같은 경우 사용자가 Google Play AR 서비스의 최신 버전으로 업데이트할 때 앱이 작동을 멈추거나 비정상 종료될 수 있습니다.

앱이 영향을 받는 SDK로 컴파일됨
앱에서 다음과 같은 영향을 받는 API를 사용합니다.

앱이 ARCore SDK 버전으로 컴파일된 경우…	영향을 받는 API를 사용합니다.	2022년 11월부터 중단되는 동작
1.19.0 이하	`Frame.getImageMetadata()`	`IllegalArgumentException`을 발생시킵니다.
1.10.0 이하	`Frame.acquireCameraImage()`	0x0 크기의 이미지를 반환합니다.

영향을 받는 앱 수정

영향을 받는 앱은 2022년 11월에 중단될 수 있습니다. 이 문제를 완화하려면 최신 ARCore SDK를 사용하여 앱을 다시 빌드하세요. 최소한 ARCore SDK 버전 1.20.0 이상으로 업그레이드해야 합니다.

영향을 받은 앱이 수정되었는지 확인

앱의 AndroidManifest.xml에 특수 meta-data 항목을 추가하여 2022년 11월 변경사항을 미리 시뮬레이션하여 앱을 테스트합니다.

타겟 기기에 AR용 Play 서비스 버전 1.29.0 이상이 설치되어 있는지 확인합니다.

앱의 AndroidManifest.xml 파일에서 기존 <application> 요소의 하위 요소로 새 <meta-data> 태그를 추가합니다.

<application …>
  …

  <!--
       Simulate the November 2022 changes in advance.
       IMPORTANT: Remove this tag when testing is completed.
       Do not include this tag in published versions of your app.
  -->
  <meta-data android:name="com.google.ar.core.session_settings"
             android:value="camera_stack_option,unified_mono" />
</application>

앱을 테스트하고 모든 ARCore 기능이 예상대로 작동하는지 확인합니다.
테스트가 완료되면 <meta-data> 태그를 삭제합니다. 게시된 앱에 이 태그를 그대로 두면 향후 예기치 않은 동작이 발생할 수 있습니다.

앱이 정상적으로 작동한다면 2022년 11월에 앱을 변경할 준비가 된 것입니다.

타임라인

기간	이벤트
2020년 11월 (ARCore SDK 버전 1.20.0)	네이티브 API가 지원 중단됩니다. 대체 네이티브 API를 사용하도록 구현을 업데이트합니다.
2021년 11월	2022년 11월에 Google Play AR 서비스에서 영향을 받는 API 구현이 보류 중인 삭제될 예정이므로 향후 발생할 수 있는 중대한 변경사항을 공지합니다.
2022년 11월	Google Play AR 서비스에서 영향을 받는 API의 구현을 삭제합니다. 1.20.0 이전 버전의 ARCore를 사용하는 앱에 중대한 변경사항을 도입합니다.