푸시

이 문서는 React Native에 대한 푸시 알림을 설정하는 방법을 다룹니다. 푸시 알림을 통합하려면 각 기본 플랫폼을 별도로 설정해야합니다. 나열된 각 안내서를 따라 설치를 완료하십시오.

1. 플랫폼 별 초기 설정

Android

프로젝트에 Firebase 추가하기

Firebase에서 제공되는 Unity 프로젝트에 Firebase 추가의 지시사항에 따라 프로젝트에 Firebase Unity SDK를 추가합니다.

가이드 완료시 확인해야 할것

• google-services.json 파일이 Assets폴더에 추가되어 있는지 확인

Dfinery Console에서 Firebase 정보 등록하기

Console에서 부가설정/채널 부가 설정/푸시/Android 설정관리에 들어가 발신자 ID를 입력하고 JSON 형식의 Firebase 사용자 인증 정보 비공개 키 파일을 업로드합니다.

발신자 ID 확인 방법

1. Firebase Console로 이동합니다.

2. 프로젝트를 선택합니다.

3. 좌측 패널에서 프로젝트 개요 오른쪽에 ⚙️ 아이콘을 클릭합니다.

4. 프로젝트 설정을 클릭합니다.

5. 프로젝트 설정 상단 탭에서 클라우드 메시징을 클릭합니다.

6. 발신자 ID를 확인합니다.

Firebase 사용자 인증 정보 비공개 키 파일 발급 방법

Firebase에서 제공하는 수동으로 사용자 인증 정보 제공을 참고하여 JSON 형식으로 키를 저장한다음 Console에 파일을 업로드 해주세요.

해당 페이지에서 확인할 수 있는 주요 내용은 다음과 같습니다.

1. Firebase Console에서 설정 > 서비스 계정을 엽니다.

2. 새 비공개 키 생성을 클릭한 다음 키 생성을 클릭하여 확인합니다.

3. 키가 들어 있는 JSON 파일을 안전하게 저장합니다.

만약 비공개 키 파일 발급에 어려움을 겪으실 경우 Firebase 사용자 인증 정보 비공개 키 파일 발급 따라해보기를 참고하여 주시기 바랍니다.

앱 매니페스트에 FirebaseMessagingService를 상속받는 서비스 추가

<application>
    ...
    <service
        android:name="com.igaworks.dfinery.DfineryFirebaseMessagingService"
        android:exported="false">
        <intent-filter>
            <action android:name="com.google.firebase.MESSAGING_EVENT" />
        </intent-filter>
    </service>
</application>

앱 매니페스트에 POST_NOTIFICATIONS 권한 추가하기

Android 13이상의 기기일 경우 POST_NOTIFICATIONS 권한이 필요합니다. AndroidManifest.xml에 해당 권한을 추가해주시기 바랍니다.

<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

다음은 작성이 완료된 AndroidManifest.xml 예시입니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" package="com.igaworks.dfinery.unity_example" android:versionCode="1" android:versionName="1.0">
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
  <uses-permission android:name="com.google.android.gms.permission.AD_ID" /><!-- 구글 광고 ID를 수집해야할 경우 추가합니다. -->
  <application android:label="@string/app_name" android:icon="@drawable/app_icon">
    <activity android:name="com.unity3d.player.UnityPlayerActivity" android:label="@string/app_name" android:screenOrientation="fullSensor" android:launchMode="singleTask" android:configChanges="mcc|mnc|locale|touchscreen|keyboard|keyboardHidden|navigation|orientation|screenLayout|uiMode|screenSize|smallestScreenSize|fontScale|layoutDirection">
      <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
      <meta-data android:name="unityplayer.UnityActivity" android:value="true" />
    </activity>
    <service android:name="com.igaworks.dfinery.DfineryFirebaseMessagingService" android:exported="false">
      <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
      </intent-filter>
    </service>
    <provider android:authorities="${applicationId}.dfinery.unity.INIT_PROVIDER" android:name="com.igaworks.dfinery.unity.DfineryUnityInitProvider" android:exported="false" />
  </application>
</manifest>

푸시 알림 채널을 Dfinery에 연동하기

푸시 알림 채널 생성

Android 8.0부터는 알림을 수신받기 위해 알림 채널 생성이 필요합니다. Dfinery.CreateNotificationChannel() 메소드를 사용하여 알림 채널을 생성할 수 있습니다.

알림 채널 API는 Android 8.0이상에서 지원하며 그 미만 기기에서는 아무런 동작을 하지 않습니다.

Dictionary<string, object> properties = new Dictionary<string, object> {
    {DFAndroidNotificationChannelProperty.ID, "dfinery_channel"},
    {DFAndroidNotificationChannelProperty.NAME, "Default Notification Channel"},
    {DFAndroidNotificationChannelProperty.IMPORTANCE, DFAndroidNotificationChannelImportance.HIGH},
    {DFAndroidNotificationChannelProperty.BADGE, true},
    {DFAndroidNotificationChannelProperty.SOUND, true},
    {DFAndroidNotificationChannelProperty.VISIBILITY, DFAndroidNotificationChannelVisibility.PUBLIC},
    {DFAndroidNotificationChannelProperty.VIBRATION, true}
};
Dfinery.CreateNotificationChannel(properties);

생성한 푸시 알림 채널 ID 등록

생성한 알림 채널의 ID를 등록합니다.

public void Awake() {
    Dictionary<string, object> config = new Dictionary<string, object> {
        {DFConfig.ANDROID_NOTIFICATION_CHANNEL_ID, "dfinery_channel"}
    };
    Dfinery.InitWithConfig("{YOUR_SERVICE_ID}", config);
}

푸시 알림 채널 그룹 생성 (선택사항)

Andorid 알림 채널에는 선택적으로 알림 채널 그룹을 설정할 수 있습니다.

알림 채널 그룹 API는 Android 8.0이상에서 지원하며 그 미만 기기에서는 아무런 동작을 하지 않습니다.

//알림 채널 그룹 생성
Dictionary<string, object> notificationChannelGroupProperties = new Dictionary<string, object> {
    {DFAndroidNotificationChannelGroupProperty.ID, "dfinery_channel_group"},
    {DFAndroidNotificationChannelGroupProperty.NAME, "Default Notification Channel Group"}
};
Dfinery.CreateNotificationChannelGroup(notificationChannelGroupProperties);
//알림 채널에 그룹 할당
Dictionary<string, object> properties = new Dictionary<string, object> {
    {DFAndroidNotificationChannelProperty.ID, "dfinery_channel"},
    {DFAndroidNotificationChannelProperty.GROUP_ID, "dfinery_channel_group"}
};
Dfinery.CreateNotificationChannel(properties);

프로젝트에 푸시 알림 아이콘 추가하기

알림 아이콘을 프로젝트에 추가하기 위해서는 Assets/Plugins/Android 경로에 .androidlib 확장자를 가진 폴더를 생성해야 합니다.

명칭은 자유로이 설정 가능합니다.

androidResources.androidlib

해당 폴더 내에 다음과 같은 형태로 푸시 알림 아이콘의 파일을 넣어주세요.

아이콘 설정은 drawable 만을 지원합니다. mipmap은 지원하지 않습니다.

androidResources.androidlib

폴더 내에 AndroidManifest.xml을 생성하여 다음과 같이 작성합니다.

package 이름은 다른 플러그인과 겹치지 않는 고유한 이름으로 지정해주세요.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
package="{YOUR_RESOURCE_PACKAGE_NAME}" 
android:versionCode="1" 
android:versionName="1.0">
</manifest>

최종적으로 아래와 같은 폴더 구조가 되면 성공입니다.

Assets/
└── Plugins/
    └── Android/
        └── androidResources.androidlib/  <-- .androidlib 확장자 폴더
            ├── AndroidManifest.xml          <-- 라이브러리 매니페스트 파일
            └── res/
                ├── drawable-mdpi/
                │   └── ic_unity.png
                ├── drawable-hdpi/
                │   └── ic_unity.png
                ├── drawable-xhdpi/
                │   └── ic_unity.png
                └── ... (기타 해상도)

이렇게 할 경우 Unity가 .androidlib 폴더를 하나의 Android 라이브러리로 인식하여 빌드시 Drawable 형태로 포함시킵니다.

푸시 알림 아이콘 설정하기

Android에서 푸시 알림을 표시하기 위해서는 아이콘 설정이 필요합니다. 아이콘 Drawable의 이름을 입력하여 설정합니다.

알림 아이콘은 시스템이 색조(tint)를 적용할 수 있으므로, 투명한 배경을 사용하는 것이 좋습니다.

아이콘 설정은 drawable 만을 지원합니다. mipmap은 지원하지 않습니다.

`DfineryUnitySettings.asset`를 사용

Android Notification Icon Name에 알림 아이콘으로 사용될 Drawable의 이름을 입력해주세요.

C# 스크립트에서 호출

푸시 알림 강조색 지정하기

알림 아이콘 강조색은 init시 config에 색상의 hexString 값을 입력하여 적용할 수 있습니다. 색상을 지정하지 않으면 시스템 기본 색상으로 표시됩니다.

• 푸시 알림 강조색은 사용 중인 OS 버전과 런처에 따라 다르게 표시될 수 있습니다.

• 값은 Hex color codes 형태로 입력해야 합니다.

`DfineryUnitySettings.asset`를 사용

Android Notification Accent Color에 알림 강조 색상을 입력해주세요.

C# 스크립트에서 호출

iOS

2. 런타임 알림 권한 요청하기

푸시 알림 권한에 대한 사용자의 허가를 받아야 합니다.

Mobile Notifications 패키지를 활용한 푸시 알림 권한 요청 예시입니다.

IEnumerator Start()
{
    var request = NotificationCenter.RequestPermission();
    if (request.Status == NotificationsPermissionStatus.RequestPending)
        yield return request;
    Debug.Log("Permission result: " + request.Status);
}

3. 토큰을 Dfinery에 연동하기

Firebase/APNS에서 발급된 토큰을 Dfinery에 연동하기 위해서 다음과 같이 작성해주시기 바랍니다.

아래는 가장 최근에 발급받은 푸시 토큰을 가져오고 Dfinery에 연동하는 예제입니다.

Android의 경우 Dfinery.getPushToken()은 Firebase Messaging API를 사용하여 푸시 토큰을 가져옵니다. 다른 방법으로 푸시 토큰을 가져와 설정하셔도 무관합니다.

public class MyPushTokenCallback : DFGetPushTokenCallback {
    public void OnGetPushToken(string pushToken) {
        if (pushToken != null) {
            Debug.Log("PushToken: " + pushToken);
            Dfinery.SetPushToken(pushToken);
        } else {
            Debug.Log("PushToken is null");
        }
    }
}
 
Dfinery.GetPushToken(new MyPushTokenCallback());

4. 푸시 클릭시 호출되는 딥링크 연동하기

Android

앱 콘텐츠 딥 링크 만들기에 따라 딥링크 설정을 해주세요.

<activity
    android:name=".MainActivity"
    android:exported="true"
    android:launchMode="singleTop"
    android:theme="@style/LaunchTheme">
    
    <!-- 기존 intent-filter -->
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
    </intent-filter>
    
    <!-- 딥링크를 위한 intent-filter -->
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="yourapp" />
    </intent-filter>
</activity>

iOS

5. 푸시 알림 수신 허용 유무 반영하기

광고성 목적이 있는 푸시의 경우 정보통신망법 에 따라 사용자에게 사전 수신동의를 받아야 합니다. 사용자에게 푸시 알림이 허용되었다는 정보를 Dfinery에 반영하기 위해서 다음의 일련의 작업을 수행하여 주시기 바랍니다.

1. 사용자에게 푸시 알림 허용에 대한 고지하기

2. 사용자의 허용/거부 의사에 대한 값을 반영하기 위해 다음의 코드를 작성

알림 수신 동의 설정하기를 참고하여 사용자가 동의한 항목에 대해 값을 입력해주시기 바랍니다. 아래 코드는 광고성 수신 동의를 허용한 예시입니다.

Dictionary<string, object> param = new Dictionary<string, object>
{
    {DFUserProfile.PUSH_ADS_OPTIN, true}
};
Dfinery.SetUserProfiles(param);

6. 완료

이제 Dfinery에서 알림을 사용하기 위한 모든 준비가 완료되었습니다.