인스턴트 게임 SDK
이 섹션에서는 인스턴트 게임 JavaScript SDK의 API 참고 자료를 제공합니다. 새로운 게임을 시작 중이라면 항상 최신 버전의 SDK를 사용하는 것이 좋습니다. 아래의 버튼을 클릭하여 최신 버전의 SDK 참고 자료를 확인하세요.
인스턴트 게임 SDK 참고 자료번들 구성 참고 자료현재 지원되는 인스턴트 게임 SDK 버전의 변경 사항을 확인하세요.
버전 7.1
변경 사항
- 네이티브 동영상 콘텐츠 렌더링: 앱이 네이티브로 동영상 콘텐츠를 렌더링하기 위한 API를 추가합니다.
- 보상형 전면 광고 API: 보상형 전면 광고는 인스턴트 게임 개발자가 수익을 얻기 위한 새로운 광고 표시 형식입니다. 사용자가 옵트인하여 광고를 보는 보상형 동영상과 달리, 보상형 전면 광고는 일반 전면 광고 대신에 표시되고 사용자가 옵트아웃할 수 있습니다. 전체 동영상을 시청하면 게임 내 보상을 받게 됩니다.
- 상단 배너 광고: 개발자가 게임 상단에 배너 광고를 표시할 수 있습니다.
버전 7.0
변경 사항
- 맞춤 초대 게이머가 Messenger를 통해 신규 게이머를 게임에 초대할 수 있습니다. 게이머에게 아직 게임을 플레이하지 않은 친구들이 표시된 '신규 게이머 초대' 섹션이 보이고, '초대'를 클릭하면 친구에게 게임을 플레이해 보라는 메시지가 전송됩니다. 초대를 여러 개 보낼 수 있습니다. 자세한 내용은 이 가이드를 참조하세요.
- 햅틱 피드백 이제 인스턴트 게임에서 통합 진동 기능이 내장된 Android 및 iOS 기기에 햅틱 피드백을 지원합니다.
- 토너먼트 API 인스턴트 토너먼트는 신규 게이머를 확보하는 좋은 방법일 뿐만 아니라 토너먼트 기간(기본 7일) 동안 게이머의 참여를 유지하는 데도 도움이 됩니다. 게이머가 자신의 타임라인에 리더보드를 공유하면 친구들에게 챌린지에 참여하라는 메시지가 표시됩니다. 뉴스피드 게재와 게임에 참여하는 게이머들의 재공유가 결합되면서 토너먼트에 관한 소식이 친구에게 빠르게 확산되어 짧은 시간 안에 많은 게이머를 확보할 수 있습니다.
- 통계 삭제 API 이는 더욱 유연한 게이머 데이터 API로 대체하기 위해 삭제되었습니다.
- postSessionScore 삭제 이를
postSessionScoreAsync로 대체하여 이 API를 통해 호출된 대화 상자에 더욱 자세한 사용자 행동 정보를 제공합니다. - shareAsync 및 updateAsync에서 사용하지 않는 매개변수 삭제
shareAsync에서 사용하지 않는 INTENT 매개변수를 삭제했습니다. 컨텍스트 세션당 맞춤 업데이트를 한 개로 제한하는 정책이 도입되어updateAsync에서 IMMEDIATE_CLEAR 전략도 삭제했습니다. - 상단 배너 광고: 개발자가 게임 상단에 배너 광고를 표시할 수 있습니다.
버전 6.3
변경 사항
- (신규) FBInstant.postSessionScore 이 API를 사용하면 게임에서 Facebook에 현재 게임 세션의 게이머 점수를 제공할 수 있습니다. Facebook은 이러한 점수를 다양한 플랫폼 통합에 사용하여 게이머가 게임을 발견하고 게임 내에서 서로 경쟁하며 게임에 재참여할 수 있도록 지원합니다.
- 오프라인 매치메이킹 원래 매치메이킹은 동기식이므로 대기 중인 게이머에게는 게임이 차단되었습니다. 이번 릴리스에서는 'matchPlayerAsync'에 대한 비동기식 옵션이 추가됩니다. 오프라인 매칭을 시작하는 게이머가 바로 그룹 스레드에 추가되고 게이머는 다른 게이머가 참여하기를 기다리는 동안 게임을 떠날 수 있습니다. 다른 게이머와 매칭되고 아직 게임에 남아 있을 경우, 해당 게이머가 추가되고, 매칭된 스레드의 컨텍스트로 전환됩니다.
- 'initializeAsync' 이후에 게이머, 컨텍스트, 로캘 및 진입점에 대한 데이터 API에 액세스 가능 이제 다시 게임 전에 데이터 API에 액세스를 시작할 수 있습니다! 예를 들어 이제 게임을 읽어들이는 동안 게이머의 로캘이나 진입점에 액세스할 수 있습니다. 이는 이차적 로딩 화면과 게임의 전반적인 로딩 요구 사항을 줄이는 데 도움이 됩니다. 이 변경 사항은 현재 웹에 적용되고 있으며, FB for Android v219, Messenger for Android v213, FB for iOS v222, Messenger for iOS v216 릴리스부터 모바일에도 적용될 예정입니다. 이전 모바일 버전은 이전의 동작을 표시하므로 'startGameAsync'를 처리한 후 업데이트된 값을 확인하세요.