게임 리더보드 열기

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

주의하세요

• 토스앱 5.221.0 버전부터 지원해요. 게임 리더보드를 지원하지 않는 버전에서는 undefined를 반환합니다.
• 게임 프로필 WebView와 화면이 겹칠 수 있어요. 게임 진입 직후 바로 리더보드를 호출하는 것은 피해 주세요.

시그니처

function openGameCenterLeaderboard(): Promise<void>;

반환 값

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

예제

리더보드 웹뷰 호출하기

WebView

import { isMinVersionSupported, openGameCenterLeaderboard } from '@apps-in-toss/web-framework';
import { Button } from "@toss-design-system/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-design-system/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>;
}