Skip to content

Wortal SDK 코어

목차

변수 (Variables)

기능

변수 (Variables)

광고

• Const ads: ads = _ads

변수 API

애널리틱스

• Const analytics: analytics = _analytics

애널리틱스 API

컨텍스트

• Const context: context = _context

컨텍스트 API

인앱 구매

• Const iap: iap = _iap

인앱 구매 API

리더보드

• Const leaderboard: leaderboard = _leaderboard

리더보드 API

알림

• Const notifications: notifications = _notifications

알림 API

플레이어

• Const player: player = _player

플레이어 API

세션

• Const session: session = _session

세션 API

토너먼트

• Const tournament: tournament = _tournament

토너먼트 API

isInitialized

• isInitialized: boolean

SDK Core가 초기화된 경우 True를 반환합니다.

기능

getSupportedAPIs

▸ getSupportedAPIs(): string[]

현재 플랫폼에서 지원하는 API를 가져옵니다.

예

const supportedAPIs = Wortal.getSupportedAPIs();
if (supportedAPIs.includes("context.shareAsync")) {
   shareWithFriendsDialog.show();
}

Returns

string[]

지원되는 API의 배열.

initializeAsync

▸ initializeAsync(): Promise<void>

SDK를 초기화합니다. 다른 SDK의 기능보다 먼저 호출해야 합니다. 초기화 시간을 단축하기 위해 스크립트가 로드되면 즉시 호출하는 것이 좋습니다.

참고: 수동 초기화 옵션이 true로 설정된 경우에만 사용할 수 있습니다. 그렇지 않으면 SDK가 자동으로 초기화됩니다.

예

Wortal.initializeAsync().then(() => {
   // SDK 사용 가능. 게임 로딩이 완료될 때까지 기다린다.
   Wortal.setLoadingProgress(100);
   Wortal.startGameAsync();
});

Returns

Promise<void>

SDK가 성공적으로 초기화되면 해결되는 프로미스입니다.

Throws

  • INITIALIZATION_ERROR
  • NOT_SUPPORTED

onPause

▸ onPause(callback): void

앱이 백그라운드에 표시될 때 호출되는 콜백을 설정합니다.

매개변수

이름 유형 설명
callback () => void 콜백을 위한 콜백.

Returns

void

onResume

▸ onResume(callback): void

앱이 포그라운드로 전환될 때 호출되는 콜백을 설정합니다.

매개변수

이름 타입 설명
callback () => void 호출할 콜백.

Returns

void

performHapticFeedbackAsync

▸ performHapticFeedbackAsync(): Promise<void>

지원되는 장치에 햅틱 피드백을 요청하고 실행합니다.

Returns

Promise<void>

햅틱 피드백이 성공적으로 요청되었을 때 해결되는 Promise.

Throws

  • NOT_SUPPORTED
  • CLIENT_UNSUPPORTED_OPERATION
  • INVALID_OPERATION

setLoadingProgress

▸ setLoadingProgress(value): void

게임 로딩이 끝날 때까지의 진행률 값을 설정합니다. 이 설정은 일부 플랫폼에서만 필요합니다. 게임이 완전히 로드된 상태의 값인 '100%'로 호출하지 않으면 게임이 정상적으로 실행되지 않습니다.

예

onGameLoadProgress(percent) {
    Wortal.setLoadingProgress(percent);
}

onGameLoaded() {
    Wortal.setLoadingProgress(100);
}

매개변수

이름 유형 설명
value number 로딩이 완료될 때까지의 백분율 표시. 범위는 0~100입니다.

Returns

void

startGameAsync

▸ startGameAsync(): Promise<void>

이 메시지는 게임의 초기 로딩이 완료되어 준비가 완료되었음을 나타냅니다. 반환된 Promise가 해결되면 컨텍스트 정보가 업데이트됩니다. 이 함수를 호출할 때 다음 조건을 만족하면 로딩 화면이 삭제됩니다:

  • initializeAsync가 호출되어 해결된 경우
  • setLoadingProgress가 100의 값으로 호출되었을 때.

참고: 수동 초기화 옵션이 "true"로 설정된 경우에만 사용할 수 있습니다. 그렇지 않으면 게임이 자동으로 시작됩니다.

예

Wortal.startGameAsync().then(() => {
   // Game is rendered to player.
});

Returns

Promise<void>

게임이 성공적으로 시작되면 해결되는 Promise.

Throws

  • INITIALIZATION_ERROR
  • NOT_SUPPORTED

authenticateAsync

▸ authenticateAsync(): Promise<AuthResponse>

플레이어 인증 프로세스를 시작합니다. 현재 플랫폼에 자체 인증 프롬프트가 있는 경우, 해당 프롬프트가 표시됩니다.

참고: 페이지를 리디렉션하거나 새로고침을 할 수 있으므로 게임을 시작하기 전에 호출해야 합니다.

예

Wortal.authenticateAsync().then(response => console.log(response));

Returns

Promise<AuthResponse>

인증 프로세스의 응답으로 해결하는 Promise.

Throws

  • AUTH_IN_PROGRESS
  • USER_ALREADY_AUTHENTICATED
  • USER_INPUT
  • NOT_SUPPORTED