2022년 11월 Android NDK용 ARCore SDK (C)의 카메라 메서드 삭제가 지원 중단됨

2022년 11월부터 Google Play AR 서비스에서 지원 중단된 메서드가 삭제됩니다. 관련된 것이 아닙니다.

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

영향을 받은 앱

2022년 11월부터 사용자가 업데이트하면 앱의 작동이 중지되거나 비정상 종료될 수 있습니다 다음과 같은 경우 최신 버전의 Google Play AR 서비스로 업그레이드하세요.

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

앱이 로 컴파일된 경우 ARCore SDK 버전...	영향을 받는 API 사용	2022년 11월부터 발생하는 브레이킹 체인지
1.22.0 이하	`ArImage_getNdkImage()` (ARCore SDK 1.23.0에서 삭제됨)	결과 `AImage` 구조체에 `NULL`를 반환합니다.
1.22.0 이하	`ArImage_getNdkCameraMetadata()` (ARCore SDK 1.23.0에서 삭제됨)	결과 `ACameraMetadata` 구조체에 `NULL`를 반환합니다.

영향을 받는 앱 수정

영향을 받는 앱은 2022년 11월에 중단될 수 있습니다. 이 문제를 완화하려면 영향을 받는 메서드에 드롭인 교체 사용:

ArImage_getNdkImage() 및 AImage_* 메서드: ArImage에서 상응하는 메서드를 사용합니다. 예를 들면 다음과 같습니다. <ph type="x-smartling-placeholder">
- AImage_getNumberOfPlanes()가 ArImage_getNumberOfPlanes()가 됩니다.
- AImage_getPlaneData()가 ArImage_getPlaneData()가 됩니다.
ArImage_getNdkCameraMetadata(): ArImageMetadata_getConstEntry()를 대신 사용합니다.

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

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

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

새 <meta-data> 태그를 기존 <application> 요소의 하위 요소로 파일 AndroidManifest.xml개 :

<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년 2월 (ARCore SDK 버전 1.23.0)	ARCore SDK에서 이전에 지원 중단된 API 서명을 삭제합니다.
2021년 11월	구현 삭제 대기 중인 향후 브레이킹 체인지 공지 2022년 11월에 영향을 받는 Google Play AR 서비스 API의 비율
2022년 11월	영향을 받는 API의 구현을 다음에서 삭제: Google Play AR 서비스 이전 ARCore 버전을 사용하는 앱에 브레이킹 체인지 적용 1.23.0.