다음을 위해 설계됨: ANDROID
Android용 Beauty AR SDK
Android용 Beauty AR SDK로 카메라 파이프라인에 뷰티 조절 기능과 개성 있는 얼굴 효과를 추가하세요. 앱 디자인을 유지하면서 텍스처를 처리할 수 있습니다.
개발자 리소스
Android용 Beauty AR SDK 문서 및 예제
ANDROID BEAUTY AR 기능
앱에 필요한 카메라 경험 구축
텍스처 파이프라인
- 카메라 텍스처 처리
- 처리된 텍스처 ID 반환
효과 선택
- 뷰티 매개변수 조절
- 라이선스가 부여된 효과 에셋 로드
네이티브 통합
- Maven 패키지 선택
- GL 스레드 수명 주기 제어
Android용 Beauty AR SDK 살펴보기
API를 카메라, 조절 기능, 효과 에셋에 연결하세요.
카메라 파이프라인에 효과 추가
텍스처 처리 콜백에서 Android용 Beauty AR SDK를 사용하세요. 프레임 크기는 입력과 일치하도록 유지하세요.
문서 읽기@Override
public int onCustomProcessTexture(
int textureId, int width, int height) {
return xmagicApi.process(textureId, width, height);
}모든 조절을 즉시 반영
문서에 명시된 효과 이름과 범위로 뷰티 패널을 Android용 Beauty AR SDK에 연결하세요.
문서 읽기xmagicApi.setEffect(
XmagicConstant.EffectName.BEAUTY_WHITEN,
50,
null,
null
);하나의 인터페이스로 효과 전환
호환되는 리소스 경로를 Android용 Beauty AR SDK에 전달하고 효과 선택기를 구성하세요.
문서 읽기// Select an asset from your licensed resource directory.
xmagicApi.setEffect(
effectName, effectValue, resourcePath, extraInfo
);시작하기
Android용 Beauty AR SDK 시작하기
- 01
- 02
- 03
// Use your licensed package and a pinned release version.
implementation "com.tencent.mediacloud:TencentEffect_S1-04:${beautySdkVersion}"// 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의 인터페이스를 어떻게 사용자 지정하나요?
지원되는 효과를 자체 미리보기와 선택기에 연결하세요. 에셋, 기능 지원, 라이선스 범위가 대상 플랫폼과 일치해야 합니다.

