원격 구성
Yandex Games SDK의 getFlags() 메소드를 이용하여 원격 설정 플래그(Remote Config)를 가져오도록 추가하세요. 게임 시작 시 플래그를 한 번 요청하는 것이 좋습니다.
저장된 플래그의 값을 얻기 위해 getFlags() 메소드를 사용하세요.
const ysdk = await YaGames.init(); // SDK를 초기화합니다.
const flags = await ysdk.getFlags(); // 메소드가 플래그 객체를 반환합니다.
// 게임 로직에 조건을 추가할 수 있습니다:
if (flags.difficult === 'hard') {
// 높은 난이도를 활성화합니다.
}
YaGames.init()
.then(ysdk => ysdk.getFlags())
.then(flags => {
// flags는 플래그 객체를 포함합니다.
// 게임 로직에 조건을 추가할 수 있습니다:
if (flags.difficult === 'hard') {
// 높은 난이도를 활성화합니다.
}
});
로컬 설정
네트워크 문제(예: 지하철에서의 연결 문제) 등 어떠한 이유로든 서버에서 원격 설정을 가져올 수 없는 경우를 대비해 게임 코드에 로컬 설정 플래그를 항상 포함시키는 것이 좋습니다. 이는 게임의 운영성을 향상시킵니다.
이를 위해 getFlags() 메소드는 추가 파라미터를 지원합니다. 로컬 설정(플랫 객체, 값은 문자열)을 defaultFlags 필드에 전달하세요.
결과 객체는 원격 설정과 로컬 설정이 결합된 형태로, 원격 설정이 우선시 됩니다.
YaGames.init()
.then(ysdk => ysdk.getFlags({ defaultFlags: { difficult: 'easy' } }))
.then(flags => {
// flags는 { difficult: 'easy' } 객체를 포함합니다.
});
클라이언트 파라미터
게임이 플레이어의 상태를 저장하고 있다면, 예를 들어, 플레이어가 한 번이라도 게임 내 화폐를 사용했는지, 얼마나 많은 레벨을 클리어했는지, 사용자를 코어 게이머로 볼 수 있는지 등의 사실을 원격 설정에서 사용할 수 있습니다. 조건에 따라 플래그를 설정하는 방법에 대한 자세한 내용은 플래그 설정 생성 섹션을 참조하세요.
클라이언트 파라미터는 getFlags() 메소드의 clientFeatures 필드에 배열 형태로 전달해야 합니다.
await 사용 예
const ysdk = await YaGames.init(); // SDK를 초기화합니다.
const player = await ysdk.getPlayer(); // 플레이어를 가져옵니다.
const payingStatus = player.getPayingStatus(); // 플랫폼 내 사용자의 결제 활동 상태를 가져옵니다.
// 사용자의 결제 활동 상태 클라이언트 파라미터로 플래그를 요청합니다.
const flags = await ysdk.getFlags({
clientFeatures: [
{name: 'payingStatus', value: payingStatus}
]
});
await 없는 예
// 클라이언트 파라미터 levels=5를 전송합니다.
YaGames.init()
.then(ysdk => ysdk.getFlags({
defaultFlags: {},
clientFeatures: [
{ name: 'levels', value: '5' }
]})
)
.then(flags => {
// 클라이언트 파라미터 조건이 작동하지 않았습니다.
// flags.showFullscreenAdOnStart === 'no'
});
// 클라이언트 파라미터 levels=10를 전송합니다.
YaGames.init()
.then(ysdk => ysdk.getFlags({
defaultFlags: {},
clientFeature를 호출해서 비동기 작업을 수행합니다s: [
{ name: 'levels', value: '10' }
]})
)
.then(flags => {
// 클라이언트 파라미터 조건이 작동하여 시작할 때 광고를 표시합니다.
// flags.showFullscreenAdOnStart === 'yes'
});
// 두 개의 클라이언트 파라미터 예시:
YaGames.init()
.then(ysdk => ysdk.getFlags({
defaultFlags: {},
clientFeatures: [
{ name: 'levels', value: '10' },
{ name: 'inAppPurchaseUsed', value: 'yes' }
]})
)
.then(flags => {
});
getFlags() 메소드의 시그니처와 인터페이스
interface IFlags {
[key: string]: string;
}
interface ClientFeature {
name: string;
value: string;
}
interface IGetFlagsParams {
defaultFlags?: IFlags;
clientFeatures?: ClientFeature[];
}
function getFlags(getFlagsParams: IGetFlagsParams = {}): IFlags {}
참고
지원팀은 완성된 게임을 Yandex Games에 게시하는 데 도움을 드릴 수 있습니다. 개발이나 테스트에 대해 궁금한 점이 있다면, Discord 채널에서 질문해 주세요.
지원 서비스는 얀덱스 게임에서 완성 된 게임을 게시 할 수 있습니다. 개발 또는 테스트에 대한 질문이 있는 경우
Yandex Games SDK 사용과 관련하여 문제가 발생하거나 질문이 있는 경우 다음 방법으로 지원팀에 문의하세요.