Hive Axyl SDK 레퍼런스
Hive Axyl SDK가 제공하는 모듈, 인터페이스, 메서드, 데이터 타입 명세입니다. 명세를 읽는 방법과 공통 규약은 레퍼런스 공통 규약을 참조하세요.
모듈
Hive Axyl SDK는 기능 단위 모듈의 조합입니다. 기능 모듈은 모두 공통 런타임인 com.com2usplatform.hiveaxyl.core를 의존하므로, 기능 모듈을 하나라도 설치하면 Core가 함께 설치됩니다. 모든 모듈은 Unity 6000.0 이상을 요구합니다.
Windows 빌드
Windows 빌드에서는 com.com2usplatform.hiveaxyl.core, com.com2usplatform.hiveaxyl.storage, com.com2usplatform.hiveaxyl.auth.addon.webauth가 네이티브 플러그인을 포함하므로, 앱을 실행하는 모든 기기에 Microsoft Visual C++ 2015-2022 재배포 가능 패키지(x64)가 설치되어 있어야 합니다.
기능 모듈은 모두 com.com2usplatform.hiveaxyl.core를 의존하므로, 기능 모듈을 하나라도 설치하면 이 요건이 함께 적용됩니다. 설치되지 않은 환경에서는 빌드한 플레이어뿐 아니라 Windows 에디터에서도 초기화 단계에서 DllNotFoundException이 발생합니다.
모듈 구성
모듈은 아래 세 종류로 나뉩니다.
런타임 모듈
모든 앱이 사용하는 SDK 런타임과, 다른 모듈이 공통으로 사용하는 기반 모듈입니다. SDK 런타임은 초기화, 서비스 조회, 결과와 오류 모델을 제공하고, 기반 모듈은 다른 모듈이 필요로 하는 외부 연동 환경을 제공합니다.
서버 API 모듈
Hive Axyl 서버를 HTTPS로 호출하는 모듈입니다. 플랫폼 제약이 없습니다.
Add-on · 플랫폼 제한 모듈
OS나 스토어의 네이티브 기능을 감싸는 모듈입니다. 이름에 addon이 들어가는 모듈과 com.com2usplatform.hiveaxyl.storage가 여기에 해당합니다. 지원 플랫폼에서만 등록되므로 HiveCore.TryResolve<T>()로 확인한 뒤 사용하세요.
런타임
| 모듈 | 패키지 | 지원 플랫폼 | 설명 | 레퍼런스 |
|---|---|---|---|---|
core | com.com2usplatform.hiveaxyl.core | 전체 | 초기화, 서비스 조회, 결과와 오류 모델을 제공하는 SDK 런타임 | 레퍼런스 |
steamworks | com.com2usplatform.hiveaxyl.steamworks | Windows, macOS | Steam 로그인·결제 Add-on이 공통으로 사용하는 Steamworks 연동 기반 모듈 | 레퍼런스 |
계정과 로그인
| 모듈 | 패키지 | 지원 플랫폼 | 최소 사양 | 설명 | 레퍼런스 |
|---|---|---|---|---|---|
auth | com.com2usplatform.hiveaxyl.auth | 전체 (서버 API) | — | 게스트·유저네임·외부 인증 제공자 로그인, 계정 연동과 해제, 토큰 발급 | 레퍼런스 |
auth.addon.apple | com.com2usplatform.hiveaxyl.auth.addon.apple | iOS, macOS | iOS 17+, macOS 15+ | Sign in with Apple 인증 Add-on | 레퍼런스 |
auth.addon.credentialmanager | com.com2usplatform.hiveaxyl.auth.addon.credentialmanager | Android | Android API 29+ | AndroidX Credential Manager를 감싼 Android 통합 자격 증명 로그인 Add-on | 레퍼런스 |
auth.addon.gpg | com.com2usplatform.hiveaxyl.auth.addon.gpg | Android | Android API 29+ | Play Games Services v2 GamesSignInClient를 감싼 Google Play Games 로그인 Add-on | 레퍼런스 |
auth.addon.steam | com.com2usplatform.hiveaxyl.auth.addon.steam | Windows, macOS | macOS 15+ | Steamworks 세션 티켓 API를 사용하는 Steam 인증 Add-on | 레퍼런스 |
auth.addon.webauth | com.com2usplatform.hiveaxyl.auth.addon.webauth | Android, Windows, iOS, macOS | Android API 29+, iOS 17+, macOS 15+ | OAuth 외부 사용자 에이전트를 사용하는 웹 인증 Add-on | 레퍼런스 |
결제
| 모듈 | 패키지 | 지원 플랫폼 | 최소 사양 | 설명 | 레퍼런스 |
|---|---|---|---|---|---|
payments | com.com2usplatform.hiveaxyl.payments | 전체 (서버 API) | — | Hive Axyl 결제 서비스 API | 레퍼런스 |
payments.addon.apple | com.com2usplatform.hiveaxyl.payments.addon.apple | iOS, macOS | iOS 17+, macOS 15+ | Apple StoreKit 인앱 결제 Add-on | 레퍼런스 |
payments.addon.google | com.com2usplatform.hiveaxyl.payments.addon.google | Android | Android API 29+ | Google Play Billing Library 9 BillingClient를 감싼 Google Play 결제 Add-on | 레퍼런스 |
payments.addon.steam | com.com2usplatform.hiveaxyl.payments.addon.steam | Windows, macOS | macOS 15+ | Steamworks 결제 승인 콜백을 처리하는 Steam Microtransactions Add-on | 레퍼런스 |
푸시 알림
| 모듈 | 패키지 | 지원 플랫폼 | 최소 사양 | 설명 | 레퍼런스 |
|---|---|---|---|---|---|
push | com.com2usplatform.hiveaxyl.push | 전체 (서버 API) | — | 디바이스 토큰 등록, 토큰의 언어와 수신 동의 변경, 사용자 연결 해제 API | 레퍼런스 |
push.addon.apns | com.com2usplatform.hiveaxyl.push.addon.apns | iOS, macOS | iOS 17+, macOS 15+ | Apple Push Notification service(APNs) Add-on | 레퍼런스 |
push.addon.applenotification | com.com2usplatform.hiveaxyl.push.addon.applenotification | macOS | macOS 15+ | 로컬 푸시 알림을 예약, 취소, 조회하는 Apple 로컬 푸시 알림 Add-on | 레퍼런스 |
push.addon.fcm | com.com2usplatform.hiveaxyl.push.addon.fcm | Android | Android API 29+ | FirebaseMessaging을 감싼 Firebase Cloud Messaging 디바이스 토큰 Add-on | 레퍼런스 |
그 밖의 기능
| 모듈 | 패키지 | 지원 플랫폼 | 최소 사양 | 설명 | 레퍼런스 |
|---|---|---|---|---|---|
mailbox | com.com2usplatform.hiveaxyl.mailbox | 전체 (서버 API) | — | 우편 발송과 회수, 발신·수신 우편 조회, 읽음 처리, 삭제를 제공하는 Hive Axyl 우편함 API | 레퍼런스 |
serviceaccess | com.com2usplatform.hiveaxyl.serviceaccess | 전체 (서버 API) | — | 서버 점검 조회, 클라이언트 업데이트 확인, 서비스 국가 제한 확인을 제공하는 서비스 접근 제어 API | 레퍼런스 |
storage | com.com2usplatform.hiveaxyl.storage | Android, Windows, iOS, macOS | Android API 29+, iOS 17+, macOS 15+ | 기기 보안 저장소에 값을 암호화해 보관하는 키-값 저장소 모듈 | 레퍼런스 |
coupon | com.com2usplatform.hiveaxyl.coupon | 전체 (서버 API) | — | 쿠폰 코드를 사용 처리하고 쿠폰의 아이템을 우편함으로 지급하는 Hive Axyl 쿠폰 API | 레퍼런스 |
analytics | com.com2usplatform.hiveaxyl.analytics | 전체 (서버 API) | — | 앱 클라이언트의 로그 이벤트를 Hive Axyl 분석 로그 서버로 전송하는 API | 레퍼런스 |
tcb | com.com2usplatform.hiveaxyl.tcb | 전체 (서버 API) | — | Tencent CloudBase(TCB)에 등록한 Cloud Function을 실행하는 API | 레퍼런스 |