Android용 푸시 알림
사전 요구 사항
- 푸시 알림 빠른 시작
- Unity3D 빠른 시작
- 선택 사항 Unity Editor Extensions
- 선택 사항 Postman 빠른 시작
Android 알림 채널 구성
Firebase 설정
사용하고 동기화해야 하는 세 개의 Google 웹사이트가 있습니다. Google/Firebase에는 프로젝트와 앱이 모두 있습니다.-
프로젝트:
- 아직 없는 경우 Firebase Console로 프로젝트를 가져옵니다.
-
앱:
- Firebase 프로젝트에는 앱이 포함되어 있습니다.
- 앱이 두 위치 모두에 동일한 이름과 식별자로 존재하는지 확인하세요(예: Unicorn Battle 및 com.playfab.unicornbattle2).
PlayFab에는 서버 개인 키 파일이 필요합니다
- 이 개인 키 파일은 Firebase Console에서 가져올 수 있습니다.
- Firebase Console:
- Project 또는 App을 선택하고 Settings 옵션을 찾습니다(여러 방법이 있으며 모두 동일한 곳으로 안내합니다).
- Service accounts 탭에서 Generate new private key 버튼을 선택하여 JSON 파일을 다운로드합니다.
개인 키 파일 사용
-
개인 키 파일은 다음 두 가지 방법 중 하나로 제공합니다.
- 개인 키 파일을 Game Manager UI: Settings(사용하는 Title) > Push Notifications > Android에 직접 업로드합니다.
- 또는 Postman이나 Server API 메서드가 활성화된 Unity 프로젝트를 사용하여 SetupPushNotification을 호출합니다.
- Name: your_game_name
- Platform: GCM
-
Credential: (private key file contents as a string):
{ ... } -
Overwrite OldARN:
true -
다음과 유사한 데이터가 포함된 HTTP 200 OK 응답을 받게 됩니다.
- (두 방법 중 하나를 사용하여) 제대로 설정되면 Game Manager UI의 Settings(사용하는 타이틀) > Push Notifications > Android에서 이 항목을 확인할 수 있습니다.
시작하기: Android + Unity용 푸시 알림
Unity 프로젝트를 설정하려면 다음을 수행하세요.- 새 Unity 프로젝트를 만듭니다.
- 선택 사항 PlayFab Unity Editor Extensions 패키지를 가져옵니다.
- Unity PlayFab SDK 패키지를 가져옵니다.
-
FCM Unity 가이드를 따라 FCM 메시징을 설치하고 푸시 알림을 위한 프로젝트를 설정합니다.
- 완료되면 이 가이드를 계속 진행하여 PlayFab에서 메시지를 수신할 수 있습니다.
- 다음 예제에서는 FCM과 PlayFab을 결합한 완전한 FCM 지원 monoBehaviour 스크립트를 제공합니다.
-
FCM 가이드에서 Firebase 플러그인을 설정하는 monobehavior 스크립트를 만들었습니다.
- 해당 monobehavior 스크립트를 계속 사용하거나, 다음 예제의 스크립트로 대체할 수 있습니다.
첫 번째 푸시 알림 설정
Unity에서 FCM 자습서에서 만든 스크립트를 열고 내용을 대체합니다.PlayFabSettings.TitleId = TITLE_ID. 자신만의 TitleId를 설정해야 합니다. 우리의 타이틀은 우리의 Firebase 키와 설정으로 등록되어 있으며 귀하의 것이 아니므로, 이 TitleId를 업데이트하지 않으면 이 예제는 작동하지 않습니다. 이 줄의 주석을 해제하고 TITLE_ID를 자신의 titleId로 대체하거나, 이전 섹션에서 언급한 선택적 Editor Extensions 플러그인에서 타이틀을 선택할 수 있습니다.Android 문제 해결
-
Firebase Console에서 테스트 푸시 알림을 보낼 수 있는지 확인합니다.
- 그렇지 않으면 Firebase 플러그인이 올바르게 설정되지 않은 것이며, 이유를 파악하려면 Firebase 문서를 검토하거나 Firebase 지원팀에 문의해야 합니다.
-
FCM 클라이언트 pushToken이 제대로 설정되었는지 확인합니다.
- 예제의
OnTokenReceived함수가 호출되어야 하며, 유효한 토큰이 있어야 합니다. - 호출되지 않으면 Firebase 플러그인이 올바르게 설정되지 않은 것이므로, 이유를 파악하려면 Firebase 문서를 검토하거나 Firebase 지원팀에 문의해야 합니다.
- 예제의
-
titleId가 소유한 타이틀로 설정되어 있고, Firebase 프로젝트의 서버 API 키로 등록되어 있는지 확인합니다.
고급 기능
server.SendPushNotification 에서 request.Package.CustomData 를 사용하여 임의의 데이터를 장치에 전달할 수 있습니다. 위 예제에서는 다음 주석이 있는 섹션으로 전달됩니다.타사 플러그인 전달은 지원되거나 보장되지는 않지만, 고급 사용자에게 제공됩니다.
