푸시 알림 빠른 시작

아티클
07/13/2023

PlayFab에서 푸시 알림은 세 가지 주요 시스템의 연결로 활성화됩니다.

플레이어의 장치 OS (Android, iOS 등)
공급 업체별 채널 (Google, Apple 등)
교차 플랫폼 메시지 라우팅 (Amazon Simple Notification Service [SNS]를 통한 PlayFab)

참고 항목

이러한 시스템 중 하나가 연결 해제되면 클라이언트는 알림 수신을 중단합니다.. 우연히 세 시스템 중 하나를 변경하고 링크를 깨는 것은 상당히 간단합니다. 또한 모든 시스템이 올바르게 구성되어 있으면 플로우의 개별 지점에서 알기가 어렵습니다.

PlayFab 푸시 라우팅 시스템

모든 PlayFab 타이틀은 주어진 시간에 하나의 Google (GCM) 및 하나의 Apple Push (APNS, APNS_SANDBOX) 알림 채널을 활성화할 수 있습니다. 다음 두 가지 방법 중 하나로 구성할 수 있습니다.

설정에서 게임 관리자 UI 사용 - 푸시 알림>.
PlayFab 관리 API사용하기 - SetupPushNotification.

자세한 설치 정보는 다음 튜토리얼을 읽어보세요.

게임 내에서의 푸시 메시지

푸시 메시지는 개발 엔진/플랫폼에 따라 다릅니다. 그러나 푸시 알림을 수신하는 가장 쉬운 방법은 SDK에 Unity 프로젝트를 사용하고 Android 용 FCM (Firebase 클라우드 메시징) 플러그인을 사용하거나 iOS 용 Unity를 사용하는 것입니다.

Android에서 푸시 받기 - 여기에는 플러그인이 필요합니다. 지원이 제일 잘되는 플러그인은 기본 FCM 플러그인입니다.
iOS에서 푸시 받기 - 기본 푸시 메시지에 플러그인을 요구하지 않습니다..

팁

FCM Unity 플러그인을 설치하는 방법에 대한 지침은 FCM 문서를 참조하거나 Android 스튜디오를 푸시하세요.

설정 테스트

제목과 클라이언트를 구성한 후 PlayFab 서버 API를 사용하여 구성을 테스트 할 수 있습니다. - SendPushNotification. 이 API를 사용하면 추가 비용없이 필요한 만큼 푸시 알림을 보낼 수 있습니다.

PlayFab CloudScript 서비스를 빠르고 안전한 서버 API 환경으로 사용할 수 있습니다. 거기에서 필요에 따라 푸시 알림을 보낼 수 있습니다.

이 방법을 사용하여 구성을 테스트하려면 다음 예제의 코드를 타이틀의 CloudScript에 업로드하거나 추가하세요.

예제

다음과 같은 시나리오를 생각해보세요.

타이틀에 있는 플레이어는 순위 통계에 따라 순위표에 액세스할 수 있습니다.
각 플레이어는 1 CH 통화를 지불하고 현재 플레이어에서 최대 5 포지션 떨어진 다른 플레이어에게 도전할 수 있습니다.

먼저 가상 화폐를 정의하는 방법에 대한 정보는 아래 예제 스크린 샷 (가상 화폐 정의 방법에 대한 정보는 통화튜토리어 참조)에 표시된 가상 화폐를 고려하세요.

PlayFab 경제 - 통화 - 새 통화

이제 각 플레이어에 대해 정의된 다음 통계를 고려해보세요 (테스트 순위표를 어떻게 생성하는지에 대한 정보를 보려면 보관된 토너먼트 결과에 액세스하기 튜토리얼을 참조).

PlayFab 플레이어 통계 - 순위

이러한 선행 조건을 설정하면 푸시 알림 챌린지 시스템을 설정할 수 있습니다.

다음 클라이엍트 코드는 CloudScript ChallengePlayer를 호출합니다.

public void ChallengeRandomClosePlayer(string currentPlayerId) {
    PlayFabClientAPI.GetLeaderboardAroundPlayer(new GetLeaderboardAroundPlayerRequest() {
        MaxResultsCount = 10,
        StatisticName = "Rank",
        PlayFabId = currentPlayerId,
    }, result => OnLeaderboardLoaded(result,currentPlayerId),OnPlayFabError);
}

private void OnLeaderboardLoaded(GetLeaderboardAroundPlayerResult leaderboard, string currentPlayerId) {
    var index = (int)(UnityEngine.Random.value * (leaderboard.Leaderboard.Count-1));
    if (leaderboard.Leaderboard[index].PlayFabId == currentPlayerId)
        index = (index + 1) % leaderboard.Leaderboard.Count;
    var targetId = leaderboard.Leaderboard[index].PlayFabId;

    PlayFabClientAPI.ExecuteCloudScript(new ExecuteCloudScriptRequest() {
        FunctionName = "ChallengePlayer",
        FunctionParameter = new Dictionary<string, object>() {
            { "TargetId", targetId }
        }
    }, null, OnPlayFabError);
}

public void OnPlayFabError(PlayFabError obj) {
    Debug.Log(obj.GenerateErrorReport());
}

ChallengePlayer CloudScript 코드는 요청을 처리하고 순위표 상태의 유효성을 검사하며 챌린지 푸시 알림을 대상에게 보냅니다.

handlers.ChallengePlayer = function (args) {
    var targetId = args.TargetId;
    var leaderboard = server.GetLeaderboardAroundUser({
        MaxResultsCount : 10,
        PlayFabId : currentPlayerId,
        StatisticName : "Rank"
    });

    for(var i = 0; i < leaderboard.Leaderboard.length; i++) {
        var target = leaderboard.Leaderboard[i];
        if(target.PlayFabId !== targetId) continue;

        // subtract virtual currency from current player
        server.SubtractUserVirtualCurrency({
            VirtualCurrency : "CH",
            PlayFabId : currentPlayerId,
            Amount : 1
        });

        // get current player profile
        var profile = server.GetPlayerProfile({
            PlayFabId : currentPlayerId
        }).PlayerProfile;

        // try to send push notification
        try {
            server.SendPushNotification({
                Recipient : targetId,
                Package : {
                    Message : `${profile.DisplayName} challenges you for a battle!`,
                    Title: "You have been challenged",
                }
            });
        } catch (ex) {
            // Target player has not registered for Push Notifications
        }
        return;
    }
}

푸시 알림 사용

푸시 알림을 사용할 수 있는 능력은 놀라운 것입니다. 그러나 악용될 경우, 그러나 사용자가 향후 알림을 수신 거부할 수 있습니다. 또는 게임을 완전히 떠날 수 있습니다.

하지만 현명하게 사용한다면 푸시 알림은 게임 커뮤니티를 구축하고 유지 관리하기 위한 최상의 도구 중 하나가 될 수 있습니다.

푸시 알림은 배달을 보장하지 않는 전송 후 지움 메시지 프로토콜입니다.

참고 항목

플레이어가 메시지를 열거나 관여할 것이라는 보장이 없음을 기억하세요. 이러한 주의 사항을 감안할 때 메시지를 게임 플레이 루프의 중요한 부분이 아닌 보너스 기능으로 사용하는 것이 좋습니다.

iOS 플랫폼의 경우 앱에 OS에서 단일성 대화 상자가 표시되어 사용자가 푸시 알림의 상태를 확인할 수 있습니다. 사용자가 초기 선택을 하면 이 설정은 다음 기간까지 유지됩니다.

앱이 업데이트되거나 다시 설치됩니다.
사용자는 휴대 전화의 설정 메뉴에서 설정을 변경합니다.

Android 앱의 경우 알림은 기본적으로 사용 설정되며 클라이언트가 자유롭게 켜고 끌 수 있습니다.

팁

모든 세션에서 알림 수신자를 다시 초기화하는 것이 좋습니다.

리소스

다음 리소스는 해당 빠른 시작의 항목에 대한 추가 정보를 제공합니다.

Firebase Unity SDK: Unity용 올인원 FCM 솔루션입니다. 이 SDK는 다른 모든 기능 중에서도 FCM을 통해 전송된 푸시 알림을 수신하고 처리할 수 있습니다.
잘 푸시하기: 예고자가 푸시 알림에 "예"하는 방법: 이 블로그 게시물에는 푸시 알림을 사용하기 위한 추가 전략과 기술이 자세히 나와 있습니다.
푸시 알림: 이 블로그 게시물은 푸시 기능의 최신 업그레이드를 설명하고 Android 용 기본 플러그인인 FCM으로 전환합니다.
Postman 빠른 시작: 이 빠른 시작에서는 Postman을 사용하여 API를 테스트하는 방법을 보여 줍니다.

다음을 통해 공유

푸시 알림 빠른 시작

PlayFab 푸시 라우팅 시스템

게임 내에서의 푸시 메시지

설정 테스트

예제

푸시 알림 사용

리소스

피드백

추가 리소스