콘텐츠로 이동

1단계. 연동 환경 구성

Steam 콘솔에서 준비한 인증 정보를 Hive 콘솔에 등록하고, 전용 플러그인으로 Steam 결제를 구현할 환경을 구성합니다.

1. Steam 콘솔 Publisher Web API Key 발급

먼저 Steamworks에서 Publisher Web API Key를 발급받습니다. 자세한 내용은 사전 준비를 참조하세요.

2. Hive 콘솔 Publisher Web API Key 입력

Steamworks에서 발급받은 Publisher Web API Key를 Hive 콘솔의 스토어 설정에 등록합니다. 자세한 내용은 Steam 인증 정보를 참조하세요.

3. Steam 결제 플러그인 설치

필수 전제 조건: Steamworks 초기화

Hive Axyl SDK는 Steamworks를 초기화하지 않으므로, 앱이 직접 초기화하고 유지해야 합니다. 앱 시작 시 SteamAPI.Init()를 호출하고, 매 프레임마다 SteamAPI.RunCallbacks()를 실행하세요. 초기화에 사용하는 SteamAPI는 Steam 결제 플러그인이 com.com2usplatform.hiveaxyl.steamworks 패키지와 함께 가져오는 외부 패키지 com.rlabrecque.steamworks.net이 제공합니다. Steamworks가 초기화되지 않은 상태에서 플러그인을 사용하면 FAILED_PRECONDITION(ExternalCode: STEAMWORKS_NOT_INITIALIZED) 오류가 발생합니다.

Steam 결제 승인 콜백 수신에 필요한 Steam 결제 플러그인은 com.com2usplatform.hiveaxyl.payments.addon.steam 패키지로 제공됩니다. SDK 설치에서 사용한 방법으로 이 패키지를 프로젝트 의존성에 추가합니다.

"dependencies": {
  "com.com2usplatform.hiveaxyl.core": "1.0.0",
  "com.com2usplatform.hiveaxyl.payments": "1.0.0",
  "com.com2usplatform.hiveaxyl.payments.addon.steam": "1.0.0"
}

플러그인은 Windows·macOS(macOS 15 이상) 데스크톱 빌드에서 동작하며, Steamworks 연동 패키지(com.com2usplatform.hiveaxyl.steamworks)가 의존성으로 함께 설치됩니다.

4. Steam 결제 플러그인 등록 및 설치 확인

플러그인 등록

Hive Axyl SDK 초기화 시 빌더에 Steam 결제 플러그인을 등록합니다. AddSteamMicrotransactions() 호출을 초기화 코드에 추가하세요.

using Hive.Axyl.Core;
using Hive.Axyl.Core.Unity;
using Hive.Axyl.Payments;
using Hive.Axyl.Payments.Addon.Steam;

// Axyl SDK 초기화 시 Steam 결제 플러그인 등록
HiveBootstrap.Initialize(config, builder =>
{
    builder.AddPayments(sandbox: true);   // 결제 (IPaymentsService). 개발·테스트 환경. 실제 서비스 빌드는 AddPayments()
    builder.AddSteamMicrotransactions();  // Steam 결제 플러그인 (ISteamMicrotransactionsPlugin)
});

플러그인 획득

등록한 Steam 결제 플러그인은 HiveCore.TryResolve<ISteamMicrotransactionsPlugin>()으로 가져옵니다. 이 플러그인은 Steam 결제 승인 콜백 수신(StartCallbackListenerAsync) 등에 사용됩니다.

using Hive.Axyl.Core;
using Hive.Axyl.Payments.Addon.Steam;

if (HiveCore.TryResolve<ISteamMicrotransactionsPlugin>(out var steamPlugin))
{
    // steamPlugin 사용 가능
}

설치 확인

다음 using 구문에서 컴파일 오류가 발생하지 않으면 설치가 완료된 것입니다.

using Hive.Axyl.Payments.Addon.Steam;

5. Hive 콘솔 상품별 가격 등급 설정

Steam 결제에 필요한 가격 등급을 설정하는 방법은 가격 등급을 참조하세요.

6. Hive 콘솔 상품 등록

판매할 상품을 등록하는 방법은 상품 등록을 참조하세요.

Caution

Steam에 등록한 상품과 Hive 콘솔에 등록한 상품의 Product ID는 서로 일치해야 합니다. Steam 콘솔에 입력된 정보를 활용하는 것을 권장합니다.

다음 단계

Steam에 등록된 상품 목록을 조회합니다.