Search
🏃🏻

[카메라] AR 이미지 인식

1. AR은 무엇인가요?

카메라로 특정 이미지를 비췄을 때 그 위로 다른 이미지가 오버레이 되는 기능이에요.

2. AR 이미지 인식 액션 설정하기

2-1. 액션 설정하기

1.
AR 기능을 설정하고 싶은 퀘스트를 선택해요.
2.
액션 종류에서 [카메라] AR 이미지 인식을 선택해요.

2-2. 액션 세부사항 설정하기

먼저 사용자가 찍어야 하는 이미지 촬영 성공 시 보여질 이미지를 설정해요.

1) 플레이어가 찍어야 하는 타깃 이미지 (필수)

플레이어가 이 이미지를 찍으면 그 위로 오버레이 이미지가 보여져요.
플레이어가 찍어야 하는 이미지의 경우 반드시 JPG 파일로 업로드 해주세요. 배경이 투명한 PNG 파일을 업로드 할 경우 AR 인식 과정에서 에러가 발생할 수 있어요.

2) 인식 성공 시 보여질 오버레이 이미지 (필수)

사용자가 찍어야 하는 이미지를 비출 시 그 위에 오버레이되는 이미지예요.
사용자가 찍어야 하는 이미지같은 비율의 이미지로 올려주세요.

3) 이미지 설정 시 주의사항

사용자가 찍어야 하는 이미지와 오버레이 이미지의 가로세로 비율을 꼭 동일하게 설정해주세요.
예시
이미지 사이즈는 가로세로 전부 700 ~ 1400 사이로 부탁드려요
예시
인식할 이미지가 디지털 파일로 있는 경우, 카메라로 찍은 사진 대신 디지털 이미지 자체를 올려주세요
예시
카메라로 찍은 이미지는 여백 없이 타겟만 나오게 찍어주세요.
예시

4) 가이드 이미지 (선택)

가이드 이미지는 AR 촬영 시 비출 대상에 대한 힌트를 보여주는 이미지예요.
상세 설명 보러가기
AR 촬영 시 어떤 대상을 비춰야 하는지 플레이어에게 힌트를 주고 싶다면 가이드 이미지를 활용해보세요.
가이드 이미지를 업로드 하지 않더라도 AR 작동에는 영향을 미치지 않아요.

5) 찍어야 하는 이미지 너비 / 높이 (권장)

찍어야 하는 이미지 사이즈를 입력해 주세요.
이 항목을 채워넣으면 이미지 인식이 더 잘 돼요.

6) 촬영 성공 시 누를 버튼 문구 (선택)

촬영 성공 시 누를 버튼 문구에 원하는 텍스트를 입력해 주세요.
플레이어가 AR 이미지 인식에 성공했을 때 해당 텍스트가 입력된 버튼을 보여줘요.

3. AR 이미지 리액션 설정하기

리액션 조건은 실행 조건 없음 을 선택해주세요.
오답이 발생하는 액션이 아니기 때문에 오답 시 리액션은 따로 설정하지 않아도 돼요.
다만, 기기별로 AR 인식률에 차이가 있기 때문에 AR을 인식이 어려운 경우 우회할 수 있는 퀘스트를 만들어 주는게 좋아요. 우회 퀘스트에 대한 자세한 설명은 여기를 참고해주세요.

4. 리얼월드 앱에서 확인하기

리얼월드 앱에서 확인하면 AR 기능이 잘 작동하는 것을 확인할 수 있어요.

5. [추가 설명] 가이드 이미지 활용 방법에 대한 안내

기본적인 AR 액션 설정 방법은 위의 1~4번 내용을 참고해주세요!

가이드 이미지란?

플레이어가 찍어야 하는 이미지에 대한 힌트를 주고 싶다면 가이드 이미지 를 활용해보세요!

가이드 이미지 작동 방식

가이드 이미지는 가급적 아래와 같은 배경이 없는 이미지(png 파일)를 사용해주세요.
오른쪽과 같이 AR 작동 시 투명도(opacity)가 적용된 상태로 화면에 가이드 이미지가 띄워져요.
AR 타겟 이미지(플레이어가 찍어야 하는 이미지) 인식이 완료되면 가이드 이미지는 사라져요.

가이드 이미지 적용 팁

업로드할 가이드 이미지에 별도의 투명도(opacity) 처리를 하지 않아도 앱에서 자동으로 처리돼요.
가이드 이미지 위치는 상/하/좌/우를 기준으로 화면 중앙에 배치되며, 화면의 높이 또는 너비에 맞춰 가득 채워진 형태로 띄워져요.
AR기능을 사용하기 위해선 카메라와 타깃 이미지 간 적정 거리가 필요해요. 화면 상에서 보여지는 가이드 이미지 크기는 타깃 이미지에 여백을 주어 크기를 작게 만들어주세요.

6. AR 기능 유의사항

AR 기능 실행 시 오류가 발생하는 경우, 타깃 이미지 혹은 오버레이 이미지를 다시 한 번 더 확인해 주세요.
카메라를 사용하는 AR 기능은 밤에 사용하기 어려워요. 빛을 충분히 공급받을 수 있는 실내 공간에서 주로 사용해주세요!
우회문제를 설정해주세요! AR을 사용하지 못하는 환경이나 AR 기능을 지원하지 않는 기기에겐 우회문제가 필수에요!
플레이어가 찍어야 하는 이미지에 특징적인 패턴이 없거나 단순하게 반복되는 패턴만 있는 경우 AR 인식이 원활하지 않아요. 이런 경우 플레이어가 찍어야 하는 이미지를 교체해 주세요.