게임 리더보드 열기

지원환경: WebViewWebView SDKv0.0.32React NativeReact Native SDKv1.3.0

실행환경: Toss App최소버전v5.221.0

openGameCenterLeaderboard

openGameCenterLeaderboard 함수로 사용자가 랭킹을 확인할 수 있어요.
서로 친구를 맺을 수 있고, 친구에게 내 점수를 자랑할 수 있어요.

주의하세요

• 토스앱 5.221.0 버전부터 지원해요. 게임 리더보드를 지원하지 않는 버전에서는 undefined를 반환합니다.
• 게임 프로필 WebView와 화면이 겹칠 수 있어요. 게임 진입 직후 바로 리더보드를 호출하는 것은 피해 주세요.
• 미니앱 정보 승인이 되지 않은 상황에서 호출하면 LeaderBoard not found 오류가 발생해요.

시그니처

function openGameCenterLeaderboard(): Promise<void>;

반환 값

• 리더보드 웹뷰를 호출해요 앱 버전이 최소 지원 버전(5.221.0)보다 낮으면 아무 동작도 하지 않고 undefined를 반환해요 (하지만 최소 지원 버전보다 낮은 유저는 게임을 실행할 수 없어요)

예제

리더보드 웹뷰 호출하기

js

import { isMinVersionSupported, openGameCenterLeaderboard } from '@apps-in-toss/web-framework';

function handleOpenGameCenterLeaderboard() {
  const isSupported = isMinVersionSupported({
    android: "5.221.0",
    ios: "5.221.0",
  });

  if (!isSupported) {
    console.warn('지원하지 않는 앱 버전이에요.');
    return;
  }
  
  openGameCenterLeaderboard();
}

React

import { isMinVersionSupported, openGameCenterLeaderboard } from '@apps-in-toss/web-framework';
import { Button } from "@toss/tds-mobile";

// '리더보드' 버튼을 누르면 리더보드 웹뷰가 열려요.
function GameCenterLeaderboardOpenButton() {
  const isSupported = isMinVersionSupported({
    android: "5.221.0",
    ios: "5.221.0",
  });

  if (!isSupported) {
    return;
  }

  function handleClick() {
    openGameCenterLeaderboard();
  };

  return <Button onClick={handleClick}>리더보드 웹뷰 호출</Button>;
}

React Native

import { isMinVersionSupported, openGameCenterLeaderboard } from '@apps-in-toss/framework';
import { Button } from "@toss/tds-react-native";

// '리더보드' 버튼을 누르면 리더보드 웹뷰가 열려요.
function GameCenterLeaderboardOpenButton() {
  const isSupported = isMinVersionSupported({
    android: "5.221.0",
    ios: "5.221.0",
  });

  if (!isSupported) {
    return;
  }

  function handlePress() {
    openGameCenterLeaderboard();
  };

  return <Button onPress={handlePress}>리더보드 웹뷰 호출</Button>;
}

예제 앱 체험하기

apps-in-toss-examples 저장소에서 with-game 코드를 내려받거나, 아래 QR 코드를 스캔해 직접 체험해 보세요.