다음에 추가할 기능
거래소
두 플레이어 간에 원본 인벤토리 아이템을 거래합니다.
Unity
확인할 수 있는 결과
구매자는 같은 아이템을 받고 판매자는 합의된 가격에서 설정된 수수료를 뺀 금액을 받습니다.
이 단계의 동영상은 아직 없습니다. 안내와 MCP 요청은 바로 사용할 수 있습니다.
거래소
같은 프로젝트 준비
이 기능 구현하기
가이드는 미리 볼 수 있습니다. 실행하려면 활성 프로젝트 키가 필요합니다. 프로젝트 준비
SDK 설치와 프로젝트 설정 가져오기가 완료되고 플레이어가 로그인해야 합니다.
이 SDK 예제는 develop을 사용합니다. 필요한 API가 설치된 SDK에 있는지 확인하세요.
빠른 시작으로 원하는 플레이어를 연결하세요. 명시적인 버튼이나 씬 동작에서 ReadListing(listingId)을 호출하세요. 파일을 여는 것만으로는 요청을 보내지 않습니다.
C#
1using System.Threading.Tasks;
2using UnityEngine;
3using PM.horizOn.Cloud.Examples.Features;
4using PM.horizOn.Cloud.Objects.Network.Responses;
5
6public class MarketplaceDemo : MonoBehaviour
7{
8 // Import the SDK Examples sample. Bind its screen to the signed-in player
9 // and set the stable projectId in the Inspector. Never use an Account Key.
10 public MarketplaceExample screen;
11
12 public Task<MarketplaceResult<MarketplaceListingView>> ReadListing(string listingId)
13 => MarketplaceQuickstart.ReadOneListing(screen, listingId);
14
15 // Wire only to the player's Buy confirmation after displaying ReadListing.
16 public Task<bool> ConfirmPurchase(string listingId)
17 => MarketplaceQuickstart.BuyReviewedListing(screen, listingId);
18
19 // false/timeout does not prove nonexecution. Use screen.RetryPending() or
20 // screen.RecoverOriginalOperation(); never replace the unresolved original.
21 // The sample refreshes Inventory, Values and Marketplace before acknowledgement.
22 // Its native file journal rejects WebGL writes; use a durable browser persister.
23}
두 플레이어로 테스트
같은 프로젝트에 로그인한 두 플레이어를 사용하세요. 통화, 수수료, 가격 규칙을 설정한 다음 장착하지 않은 아이템을 등록하고 구매를 명시적으로 확인하세요.
기존에 로그인한 세션을 사용하세요. 구매가 확인되지 않으면 원본 요청을 보관하고 그대로 재시도한 다음 인벤토리와 잔액을 새로 고치세요.
취소 후에도 소유자가 수령할 때까지 원본 아이템을 보호합니다. 이전 소유자가 삭제된 경우에만 복구할 수 있습니다.
판매 목록과 중복 실행 방지 정보는 프로젝트에 한 번만 저장됩니다. 플레이어는 참조와 제한된 상태 데이터만 유지합니다.
새 기능을 테스트하세요.
구매자는 같은 아이템을 받고 판매자는 합의된 가격에서 설정된 수수료를 뺀 금액을 받습니다.
게임 설정과 같은 프로젝트를 대시보드에서 선택하세요.
엔드포인트
- GET
/marketplace/limits - GET
/marketplace/rules - GET
/marketplace - GET
/marketplace/listings - GET
/marketplace/listings/{listingId} - POST
/marketplace/listings - POST
/marketplace/listings/{listingId}/buy - POST
/marketplace/listings/{listingId}/cancel - GET
/marketplace/operations/{operationId} - POST
/marketplace/listings/{listingId}/retry-return
문서와 대시보드
문서 읽기
