Unity 앱 연동¶
Unity 앱의 메트릭 데이터를 수집하여 앱 성능을 시각화된 방식으로 분석합니다.
읽기 경로¶
- 최초 연동: 먼저 빠른 시작을 참조하십시오.
- 전체 연동: 이 문서를 계속 읽으십시오.
- 파라미터 상세: SDK 초기화, RUM 설정, Log 설정, Trace 설정 참조
- 사용자 정의 기능: 사용자 정의 태그 사용, RUM 수동 추적, 데이터 수집 마스킹 참조
- 고급 시나리오: 네이티브 및 Unity 하이브리드 개발 참조
- 문제 해결: 문제 해결 참조
전제 조건¶
주의
RUM Headless 서비스가 이미 활성화된 경우 전제 조건이 자동으로 설정되므로 바로 앱을 연동할 수 있습니다.
- DataKit 설치
- RUM 수집기 설정
- DataKit을 공인 네트워크에서 접근할 수 있도록 설정하고 IP 지리 정보 라이브러리를 설치
앱 연동¶
- 실제 사용자 모니터링(RUM) > 앱 생성 > Android/iOS로 이동합니다.
- Unity Android 및 Unity iOS에 대해 각각 앱을 생성하여 Android 및 iOS 플랫폼의 RUM 데이터를 각각 수신합니다.
- 각 플랫폼의 앱에 해당하는 앱 이름과 앱 ID를 입력합니다.
-
앱 연동 방식을 선택합니다.
- 공인 네트워크 DataWay: DataKit 수집기 설치 없이 RUM 데이터를 직접 수신합니다.
- 로컬 환경 배포: 전제 조건을 충족한 후 RUM 데이터를 수신합니다.
설치¶
소스 코드 주소: https://github.com/GuanceCloud/datakit-unity
데모 주소: https://github.com/GuanceCloud/datakit-unity/blob/dev/Assets/Scenes
- 최신 ft-sdk-unity.unitypackage를 다운로드합니다.
Assets->Import Package->Custom Package...메뉴로ft-sdk-unity.unitypackage를 가져옵니다.- JSON 파싱 서드파티 라이브러리
"com.unity.nuget.newtonsoft-json"를 추가합니다.Package Manager->Add Package by name ...에서 추가할 수 있습니다. FTSDK.prefab을 첫 번째 씬으로 드래그하고FTSDK.cs의_InitSDK메서드 내에서 SDK를 초기화합니다.FTViewObserver.prefab을 다른 씬으로 드래그하여 페이지View수명 주기와 앱 절전 및 깨우기를 모니터링합니다.Application.logMessageReceived를 통해 Unity 크래시 데이터와 일반 로그 데이터를 수신 및 변환합니다. 예시는 빠른 시작 및 RUM 수동 추적을 참조하십시오.
Assets/Plugins
├── Android
│ ├── FTUnityBridge.java // Android 브리지
│ ├── InnerClassProxy.java // Android 내부 설정 프록시
│ ├── ft-sdk-release.aar // Android SDK
│ ├── gson-2.8.5.jar // Android SDK 서드파티 종속 라이브러리
├── iOS
│ ├── FTMobileSDK.xcframework // iOS SDK
│ ├── FTUnityBridge.mm // iOS 브리지
├── FTSDK.cs // FTSDK.prefab 바인딩 스크립트
├── FTSDK.prefab // SDK 초기화 프리팹
├── FTUnityBridge.cs // Unity 브리지, iOS·Android 등 플랫폼 메서드 연결
├── FTViewObserver.cs // FTViewObserver.prefab 바인딩 스크립트
├── FTViewObserver.prefab // View 페이지 모니터링 프리팹
├── UnityMainThreadDispatcher.cs // UnityMainThreadDispatcher.prefab 바인딩 스크립트
├── UnityMainThreadDispatcher.prefab // 메인 스레드 소비 큐 프리팹
- 네이티브 Android 및 iOS 프로젝트에 이미 네이티브 SDK가 통합된 경우
_InitSDK메서드를 주석 처리하여 중복 설정을 방지해야 합니다. 구체적인 시나리오는 네이티브 및 Unity 하이브리드 개발을 참조하십시오. - iOS Plugin Inspector 설정:
FTMobileSDK.xcframework는 동적 라이브러리이므로Add to Embedded Binaries를 선택해야 합니다. 이 옵션을 선택하면 Unity가 Xcode 프로젝트 옵션을 설정하여 플러그인 파일을 최종 앱 번들에 복사합니다.
네이티브 SDK가 이미 통합된 경우 Android의
gson-2.8.5.jar,ft-sdk-release.aar및 iOS의FTMobileSDK.framework는 Unity 프로젝트에서 제거할 수 있습니다.
Android의 OkHttp 요청 및 시작 시간 기능은ft-plugin과 함께 사용해야 합니다. 자세한 설정은 Android SDK를 참조하십시오.
초기화 설명¶
최소 초기화 예시는 빠른 시작을 참조하십시오.
전체 SDKConfig 파라미터 설명은 SDK 초기화를 참조하십시오.
상세 설정 바로가기¶
고급 시나리오¶
FAQ¶
전역 변수 추가로 필드 충돌 방지¶
사용자 정의 필드와 SDK 데이터의 충돌을 방지하려면 태그 이름에 프로젝트 약어 접두사를 추가하는 것이 좋습니다. 예를 들어 custom_tag_name과 같습니다. 프로젝트에서 사용하는 key 값은 소스 코드에서 확인할 수 있습니다. SDK 전역 변수에 RUM, Log와 동일한 변수가 있는 경우 RUM, Log가 SDK의 전역 변수를 덮어씁니다.