Unity

Search…
Unity
Push Notifications are available only for the supported platforms: iOS, Android, Windows Store/Windows Phone 8.1/10.
To enable Push Notifications you will have to perform the following actions:
Add the application to your space in devtodev system
Android. Get API key from Google APIs Console. It is necessary to activate Google Cloud Messaging for Android before key generation. Detailed information on how to receive an API key you can find in native Android devtodev SDK documentation​
iOS. Generate Developer or Production Certificate for the application and get Private key file (.p12) on its basis. Detailed information on how to receive a Private key file you can find in native iOS devtodev SDK documentation​
Submit the data to the application settings in devtodev system
Integrate devtodev SDK to the application (see the "SDK integration" to learn more about integrating and initializing devtodev SDK)
Add several lines of the code to switch in the push notification to the SDK
Create a campaign for sending push-notifications in "Push" section
SDK Integration
Android platform features:
Go to Firebase console and then to your project or create a new one. Here is complete guide on adding your project to Firebase console and enabling Cloud messaging.
Download google-services.json from your Firebase console. Add this file into your project’s Assets folder.
Please do the following to find google-services.json:
1.
Choose your project in the Firebase console
2.
Choose project settings in the Project overview
3. Scroll down to the SDK setup and configuration. Click on the google-services.json
Using devtodev and Firebase Messaging services at the same time
If you want to use both devtodev and Firebase Messaging services at the same time, you need to disable Firebase listener.
Find androidmanifest.xml used in your app. If you don’t use Custom Manifest, you need to create it. Tick the Custom Main Manifest checkbox:
​
​

You can read more about the manifest here.
Add the following line to the “Application” section:
1
<service android: name = "com.google.firebase.messaging.cpp.ListenerService"
2
android: exported = "true"
3
android: enabled = "false"
4
tools: node = "replace" />
Copied!
You should get something like this:
1
<?xml version="1.0" encoding="utf-8"?>
2
<manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" package="com.devtodev.unitysdk2" android:versionCode="1" android:versionName="1.0">
3
  <application android:label="@string/app_name" android:icon="@drawable/app_icon">
4
    <service android:name="com.google.firebase.messaging.cpp.ListenerService" android:exported="true" android:enabled="false" tools:node="replace" />
5
    <!-- The MessagingUnityPlayerActivity is a class that extends
6
         UnityPlayerActivity to work around a known issue when receiving
7
         notification data payloads in the background. -->
8
    <activity android:name="com.google.firebase.MessagingUnityPlayerActivity" android:configChanges="fontScale|keyboard|keyboardHidden|locale|mnc|mcc|navigation|orientation|screenLayout|screenSize|smallestScreenSize|uiMode|touchscreen">
9
      <intent-filter>
10
        <action android:name="android.intent.action.MAIN" />
11
        <category android:name="android.intent.category.LAUNCHER" />
12
      </intent-filter>
13
      <meta-data android:name="unityplayer.UnityActivity" android:value="true" />
14
    </activity>
15
    <service android:name="com.google.firebase.messaging.MessageForwardingService" android:exported="true" />
16
  </application>
17
</manifest>
Copied!
Windows Store 10 platform features:
Build a Windows Store App in Unity. After the app is built, Visual Studio project will be created. Proceed with the following changes.
There is a difference in the implementation of the elements mentioned below for different types of projects:
.NET + D3D: Put the following source in your App class (usually it is an App.cs file) at the end of the ApplicationView_Activated(CoreApplicationView sender, IActivatedEventArgs args)​ function.
1
private void ApplicationView_Activated(CoreApplicationView sender, IActivatedEventArgs args) {
2
    //...other code
3
    DevToDev.ActivatedEventHandler.Handle(args);
4
}
Copied!
.NET + XAML: Put the following source in your App class (usually it is an App.xaml.cs file) at the end of the OnLaunched(LaunchActivatedEventArgs args) and OnActivated(IActivatedEventArgs args) functions.
1
protected override void OnLaunched(LaunchActivatedEventArgs e) {
2
    //...other code
3
    DevToDev.ActivatedEventHandler.Handle(e);
4
}
5
​
6
protected override void OnActivated(IActivatedEventArgs args) {
7
    //...other source
8
    DevToDev.ActivatedEventHandler.Handle(args);
9
}
Copied!
IL2CPP + XAML: Put the following source in your App class (usually it is App.xaml.cpp file).
Add several lines of code in a generated App.xaml.cpp class.
After defining headers:
1
//...headers
2
extern "C" __declspec(dllimport) void __stdcall AddActivatedEventArgs(IInspectable* activatedEventArgs);
Copied!
And at the end of of the App::OnLaunched(LaunchActivatedEventArgs^ e) and App::OnActivated(IActivatedEventArgs^ args) functions.
For Example:
1
void App::OnActivated(IActivatedEventArgs^ args) {
2
    //...other code
3
    AddActivatedEventArgs(reinterpret_cast<IInspectable*>(static_cast<Platform::Object^>(args)));
4
}
5
​
6
void App::OnLaunched(LaunchActivatedEventArgs^ e) {
7
    //...other code
8
    auto args = static_cast<IActivatedEventArgs^>(e);
9
	AddActivatedEventArgs(reinterpret_cast<IInspectable*>(static_cast<Platform::Object^>(args)));
10
}
Copied!
IL2CPP + D3D: Put the following source in your App class (usually it is App.cpp file).
Add several lines of code in a generated App.cpp class.
After defining headers:
1
//...headers
2
extern "C" __declspec(dllimport) void __stdcall AddActivatedEventArgs(IInspectable* activatedEventArgs);
Copied!
And at the end of of the App::OnActivated(CoreApplicationView^ sender, IActivatedEventArgs^ args) function.
1
void App::OnActivated(CoreApplicationView^ sender, IActivatedEventArgs^ args) {
2
    //...other code
3
    AddActivatedEventArgs(reinterpret_cast<IInspectable*>(static_cast<Platform::Object^>(args)));
4
}
Copied!
Make sure that these functions are enabled in Package.appmanifest of you project (the flag "Toast capable" is enabled by default for Windows 10+ projects, it is absent in the manifest).
Add the following three Background Tasks in Package.appmanifest:
Entry point for Push Notification tasks type:
1
devtodev.background.PushNotificationTriggerTask
Copied!
Entry points for System Event tasks type:
1
devtodev.background.ToastNotificationActionTriggerTask
2
devtodev.background.ToastNotificationHistoryChangedTriggerTask
Copied!
You must also associate your application with the Windows Store app (otherwise push notifications will not be delivered). Open "Store->Associate App with the Store" menu, login with your Live ID and pick the appropriate application form the list. A file Package.StoreAssociation.xml will be added into the Project.
​
The specificity of integration on iOS platform
1.
Build an iOS App in Unity. After the app is built, Xcode project will be created. Proceed with the following changes
2.
Enable push notifications in your Xcode project
3.
The library provides support for iOS 10 notification attachments, such as images, animated gifs, and video. In order to take advantage of this functionality, you will need to create a notification service extension alongside your main application
4.
Create a new iOS target in Xcode (File -> New -> Target) and select the Notification Service Extension type
5.
​In Member Center, the Push Notifications service will appear as Configurable (not Enabled) until you create a client SSL certificate
Add devtodevAppExtensions.framework to newly created extension. Make sure that Deployment Target is pointed as iOS 10.0 or higher:
Make sure that field Architectures contains "Standard architectures armv7, arm64" setting both in the project and the extension build settings:
Modify your extension:
1.
Delete all dummy source code for your new extension
2.
Inherit from DTDMediaAttachmentExtension in NotificationService
1
//NotificationService.h
2
#import <devtodevAppExtensions/devtodevAppExtensions.h>
3
​
4
@interface NotificationService : DTDMediaAttachmentExtension
5
​
6
@end
7
​
8
//NotificationService.m
9
#import "NotificationService.h"
10
​
11
@interface NotificationService ()
12
​
13
@end
Copied!
Adding Capabilities
Use Xcode to enable push notifications in the target’s Capabilities pane:
Enable Background Modes and Remote notifications under the target’s Capabilities section:
Two ways to integrate push notifications:
Using the graphic interface:
1.
Open the Window/devtodev menu element
2.
Switch Push Notifications tumbler on
3.
If you need to use push token for some aims or to handle the getting of notifications by user, add the GameObject with the following function to the scene:
1
public void PushReceived(IDictionary<string, string> pushAdditionalData) {
2
     //pushAdditionalData - push-notification data that you send to your app
3
}
4
​
5
public void PushOpened(DevToDev.PushMessage pushMessage, DevToDev.ActionButton actionButton) {
6
     //pushMessage - DevToDev.PushMessage. Represents toast notification message
7
     //actionButton - DevToDev.ActionButton. Represents toast button that was clicked. Could be null if toast body was clicked
8
}
9
​
10
public void PushTokenFailed(string error) {
11
     //handle push-notifications error here
12
}
13
​
14
public void PushTokenReceived(string pushToken) {
15
     //pushToken - your push token
16
}
Copied!
4.
Set the target game object, needed script and functions in the interface:
​
​​
Using code:
Before calling Analytics.Initialize add the following strings:
1
public void PushReceived(IDictionary<string, string> pushAdditionalData) {
2
     //pushAdditionalData - push-notification data that you send to your app
3
}
4
​
5
public void PushOpened(DevToDev.PushMessage pushMessage, DevToDev.ActionButton actionButton) {
6
     //pushMessage - DevToDev.PushMessage. Represents toast notification message
7
     //actionButton - DevToDev.ActionButton. Represents toast button that was clicked.
8
     //               Could be null if toast body was clicked
9
}
10
​
11
public void PushTokenFailed(string error) {
12
     //handle push-notifications error here
13
}
14
​
15
public void PushTokenReceived(string pushToken) {
16
     //pushToken - your push token
17
}
18
​
19
DevToDev.PushManager.PushReceived = PushReceived;
20
DevToDev.PushManager.PushOpened = PushOpened;
21
DevToDev.PushManager.PushTokenFailed = PushTokenFailed;
22
DevToDev.PushManager.PushTokenReceived = PushTokenReceived;
23
​
24
DevToDev.PushManager.PushNotificationsOptions = (DTDNotificationOptions.Alert | DTDNotificationOptions.Badge | DTDNotificationOptions.Sound | DTDNotificationOptions.Provisional); //Notification options for iOS, optional property
25
DevToDev.PushManager.PushNotificationsEnabled = true; 
26
​
27
// FOR ANDROID ONLY! Optional. Using custom push-notification icons on Android.
28
// <summary> To set the custom icons to be shown in push-notification on the SDK part,
29
// use the following methods.
30
// Attention! Icons which set in the push-notification wizard 
31
// have priority over the icons which set in these methods.</summary>
32
// <param name="iconName">Icon file from resources of your app
33
// (from Assets/Plugins/Android/res folder)</param>
34
​
35
//FOR ANDROID ONLY! To set the small icon:
36
DevToDev.PushManager.CustomSmallIcon = iconName;
37
​
38
//FOR ANDROID ONLY! To set the large icon: 
39
DevToDev.PushManager.CustomLargeIcon = iconName;
Copied!
Creating a new push-notification in devtodev interface
 1. Open PUSH NOTIFICATIONS section and click on the "Add new campaign" button
2. Fill in the campaign name, select an app for delivery
3. Choose a user group to send a message. You can choose an existing segment or create a new one
4. Enter notification details
5. Schedule the delivery
6. That's it!
You can create a campaign only after at least one push token comes from devtodev SDK integrated into your application. Otherwise, the app will not be displayed in the list.
Windows 8.1 and Windows 10
Abode Air
Last modified 1mo ago
Export as PDF
Copy link
Contents
SDK Integration
Android platform features:
Windows Store 10 platform features:
The specificity of integration on iOS platform
Adding Capabilities
Creating a new push-notification in devtodev interface