다음을 위해 설계됨: ANDROID

Android용 Beauty AR SDK

Android용 Beauty AR SDK로 카메라 파이프라인에 뷰티 조절 기능과 개성 있는 얼굴 효과를 추가하세요. 앱 디자인을 유지하면서 텍스처를 처리할 수 있습니다.

개발자 리소스

Android용 Beauty AR SDK 문서 및 예제

크리에이터 영상에 개성 더하기

사용자가 Android 카메라에서 외모와 필터를 조절할 수 있게 하세요.

발화자에게 집중

적절한 효과 리소스로 카메라 미리보기에 배경 흐림을 제공하세요.

ANDROID BEAUTY AR 기능

앱에 필요한 카메라 경험 구축

텍스처 파이프라인

  • 카메라 텍스처 처리
  • 처리된 텍스처 ID 반환

효과 선택

  • 뷰티 매개변수 조절
  • 라이선스가 부여된 효과 에셋 로드

네이티브 통합

  • Maven 패키지 선택
  • GL 스레드 수명 주기 제어

Android용 Beauty AR SDK 살펴보기

API를 카메라, 조절 기능, 효과 에셋에 연결하세요.

텍스처 입력

카메라 파이프라인에 효과 추가

텍스처 처리 콜백에서 Android용 Beauty AR SDK를 사용하세요. 프레임 크기는 입력과 일치하도록 유지하세요.

문서 읽기
CameraProcessor.java
@Override
public int onCustomProcessTexture(
    int textureId, int width, int height) {
  return xmagicApi.process(textureId, width, height);
}

커스터마이징

나만의 인터페이스, 나만의 스타일.

앱과 일관된 경험을 유지하세요.

네이티브에 어울리는 조절 기능

Android용 Beauty AR SDK에 맞게 뷰티 조절 기능을 디자인하고 테마가 달라도 같은 효과 설정을 유지하세요.

문서 읽기

시작하기

Android용 Beauty AR SDK 시작하기

  1. 01

    라이선스 준비

    라이선스를 애플리케이션 식별자에 맞추세요.

    Beauty AR 콘솔 열기
  2. 02

    Android용 Beauty AR SDK 추가

    플랫폼 가이드에 따라 프로젝트를 연결하세요.

    통합 가이드 따르기
  3. 03

    첫 프레임 처리

    Android용 Beauty AR SDK를 인증하고 리소스를 복사한 후 첫 카메라 텍스처를 처리하세요.

    라이선스 설정
Android Beauty AR SDK
build.gradle
// Use your licensed package and a pinned release version.
implementation "com.tencent.mediacloud:TencentEffect_S1-04:${beautySdkVersion}"
LicenseSetup.java
// Authenticate before creating XmagicApi.
TELicenseCheck.getInstance().setTELicense(
    context, licenseURL, licenseKey,
    new TELicenseCheckListener() {
      @Override
      public void onLicenseCheckFinish(int code, String message) {
        if (code == TELicenseCheck.ERROR_OK) {
          // Initialize with your copied resource directory.
        }
      }
    });

Android용 Beauty AR SDK 자주 묻는 질문

Android용 Beauty AR SDK는 어떻게 추가하나요?

라이선스에 맞는 Maven 패키지를 추가하고 버전을 고정하세요. 필요한 모델과 효과 리소스를 복사하고 문서의 ABI 및 release 빌드 규칙을 따르세요.

Android용 Beauty AR SDK의 대상 기기는 무엇인가요?

현재 가이드는 Android 7.0 이상을 권장하며 ARMv7 및 ARM64 지원을 명시합니다. 사용자가 실제로 사용하는 기기에서 선택한 효과를 테스트하세요.

Android용 Beauty AR SDK가 카메라 프레임을 캡처해 주나요?

Core SDK 통합은 앱이 제공한 프레임을 처리합니다. 공식 샘플에 포함된 카메라 컴포넌트를 캡처 경험 구축 시 참고할 수 있습니다.

Android용 Beauty AR SDK는 어떻게 정리하나요?

GL 컨텍스트가 종료되기 전에 GL 스레드에서 onDestroy를 호출하세요. 문서의 일시 중지 및 재개 수명 주기를 따르세요. 메인 스레드에서 파괴하면 리소스 누수가 발생할 수 있습니다.

모든 패키지에 모든 효과가 포함되나요?

아니요. 패키지별 권한과 필요한 에셋 파일이 다릅니다. 필요한 라이선스 효과를 선택하고 앱에서 제공하기 전에 리소스를 확인하세요.

Kotlin 또는 Java로 Android용 Beauty AR SDK를 통합하려면 어떻게 하나요?

Android 프로젝트와 manifest 설정을 따르고 필요한 런타임 권한과 Activity 정리를 처리하세요. 앱의 백그라운드 및 포그라운드 전환을 포함해 실제 기기에서 테스트하세요.

앱 출시 전에 Android용 Beauty AR SDK를 어떻게 테스트하나요?

라이선스로 허용된 입력과 효과 처리를 테스트하세요. 카메라 사용 시 권한과 미리보기 종료 후 정리도 확인하세요.

Android용 Beauty AR SDK의 인터페이스를 어떻게 사용자 지정하나요?

지원되는 효과를 자체 미리보기와 선택기에 연결하세요. 에셋, 기능 지원, 라이선스 범위가 대상 플랫폼과 일치해야 합니다.

Android Beauty AR 통합 지원

카메라 경험 구현하기

앱에 맞는 라이선스와 Android용 Beauty AR SDK로 개발을 시작하세요.