> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Introducción a Android Studio y las notificaciones push
> Conecte Android Studio, Google Play Services, Firebase Cloud Messaging y PlayFab para enviar notificaciones push a sus aplicaciones cliente de Android.
## Información general
Este tutorial se ha diseñado para ayudarle a poner en marcha la integración de PlayFab en Android con notificaciones push.
Las notificaciones push requieren configuración en varios sistemas. Antes de empezar, hablemos de cómo funciona la infraestructura. Hay 4 entidades que participan en el proceso:
1. **Google Play Services**
2. **Firebase Cloud Messaging Services** (**FCM**, creado sobre el antiguo **Google Cloud Messaging**).
3. **Servicios de PlayFab**
4. **Aplicaciones cliente**
### 1. Google Play Services
Google Play Services identifica su página en Play Market mediante un nombre de paquete.
Un ejemplo de esto sería: **com.bob.games.matchthree**.
Cuando se registra en Google Play, el nombre del paquete se convierte en un identificador único de la aplicación y sirve para muchos fines, desde la instalación a través de Play Store hasta la prevención de suplantaciones.
### 2. Firebase Cloud Messaging (FCM)
Los servicios de Firebase Cloud Messaging le ofrecen un sistema basado en la nube para enviar, dirigir y entregar sus notificaciones push.
También permite que otros servicios (como PlayFab) envíen notificaciones push en su nombre mediante la clave de servidor de FCM.
### 3. Servicios de PlayFab
Los servicios de PlayFab usan entonces la clave de servidor de FCM para enviar notificaciones push a sus clientes.
### 4. Servicios de cliente
Por último, su aplicación cliente puede recibir notificaciones y procesarlas según sea necesario.
### División en cuatro partes
Como resultado, necesitamos configurar *4 sistemas diferentes*. Para ello, nuestro tutorial se divide en 4 capítulos, que cubren la configuración de cada pieza.
El *orden* en que configure los sistemas es importante.
## Requisitos previos
* Debe tener una cuenta de Google.
* Debe tener una cuenta de PlayFab.
* Un icono de notificación generado con el [generador de iconos de notificación](https://romannurik.github.io/AndroidAssetStudio/icons-notification.html) de Android Asset Studio.
## Escenario
En esta sección de nuestro tutorial, ensamblaremos una aplicación denominada Foo PlayFab App. Es una aplicación de Android que tiene las siguientes funciones:
* Inicia sesión en PlayFab mediante un identificador de dispositivo Android.
* Recibe notificaciones push de PlayFab.
Nuestro nombre de paquete será com.foo.playfab.app.
Asegúrese de usar su propio nombre de paquete y título al seguir este tutorial.
### Capítulo 1: Configuración de Firebase
Empiece a configurar Firebase mediante su [página de consola oficial](https://console.firebase.google.com/). Se le presentará una página donde puede agregar un nuevo proyecto.
* Para ello, seleccione el área **Add project**, como se muestra en la imagen siguiente.
* Se le pedirá que proporcione un **nombre de proyecto** (en este tutorial usamos nuestra **Foo PlayFab App**, pero *asegúrese* de idear su *propio* nombre al seguir este tutorial).
* Seleccione el botón **Create Project** para avanzar al paso siguiente.
Se le redirigirá al **panel del nuevo proyecto**.
* Agregue una nueva **aplicación Android** al proyecto seleccionando el área que se muestra en la imagen siguiente.
Agregar una nueva **aplicación** requiere 3 pasos.
1. En primer lugar, debe proporcionar un **nombre de paquete de Android**. Nosotros usamos **com.foo.playfab.app**, pero asegúrese de idear su *propio* **nombre de paquete** al seguir este tutorial.
2. Seleccione el botón **Register App** para pasar al paso siguiente.
El paso 2 le permite descargar un archivo de configuración denominado **google-services.json**. Se usará más adelante en la **aplicación** para configurar automáticamente los servicios de **Google**.
* Después de descargarlo, seleccione el botón **Continue** para pasar al paso siguiente.
3. El paso final ofrece información sobre cómo configurar su proceso de compilación para conectar los SDK de Firebase y Google Play.
Puede ignorar esta información, ya que usaremos una herramienta automatizada integrada en Android Studio que realiza esta configuración automáticamente.
* Seleccione el botón **Finish** para continuar.
* Una vez agregada la **aplicación**, aparecerá en el panel.
* En este punto, la configuración está completa y necesitamos extraer la clave de servidor de FCM (que usaremos para conectar las notificaciones push de PlayFab).
* Vaya a **Project settings**, como se muestra en la imagen siguiente.
* En **Project settings**, vaya a la pestaña **Cloud Messaging**.
* Busque el área **Server Key** (el área en rojo de la imagen que se muestra a continuación).
* Copie esta **clave** y guárdela en un lugar seguro y de fácil acceso.
En este punto, hemos hecho todo lo necesario en Firebase para habilitar las notificaciones push.
### Capítulo 2: Configuración de Google Play Console
Cuando su aplicación esté lista, lo más probable es que cree un proyecto de Google Console para mantener una página de producto en Play Store. Veamos el proceso de creación de un proyecto de Google Play y su vinculación con el proyecto de Firebase.
Empiece por visitar la [página de Google Play Console](https://play.google.com/apps/publish) y crear un nuevo proyecto, como se muestra en la imagen siguiente.
* Asigne el **título**.
En este ejemplo, usamos **Foo PlayFab App**. Asegúrese de idear su *propio* título y nombre de paquete mientras sigue este tutorial.
* Seleccione el botón **Create** para continuar.
* Se abrirá la página del **proyecto de Google Play Console**.
* Seleccione **Services & APIs** en el menú lateral.
* Se abrirá la página **Services configuration**.
* Busque el panel **Firebase Cloud Messaging**.
* Seleccione el botón **Link a Sender ID**, como se muestra en la imagen siguiente.
Para vincular el **identificador de remitente**:
* Use la clave de servidor de FCM que recibió (y guardó) al usar la consola de Firebase en el capítulo anterior.
* Cuando termine, seleccione el botón **Link**, como se muestra en nuestro ejemplo.
* Dedique un momento a comprobar que el **identificador de remitente** que se muestra en **Google Play Console** coincide con el de la **consola de Firebase**, como se muestra en el ejemplo siguiente.
En este punto, el **proyecto de Google Play Console** está correctamente vinculado al **proyecto de Firebase**.
### Capítulo 3: Configuración del título de PlayFab
El propósito de este capítulo es mostrarle cómo configurar los servicios de PlayFab para que puedan enviar notificaciones push al jugador en su nombre.
* En primer lugar, debe ir a **Title settings** en el menú de configuración de su título.
* Seleccione la pestaña **Push Notifications**.
* Para la opción de Android, seleccione el icono de **configuración**.
* Se le pedirá su **clave de API de servidor de Google**.
* Copie la que recibió a través de la consola de Firebase, como se muestra en el ejemplo proporcionado a continuación.
* Si todo es correcto, se le presentará una página que muestra las **notificaciones push** como **activas**.
Con esto concluye la configuración de su título de PlayFab.
### Capítulo 4: Configuración del proyecto de Android Studio
Para utilizar el JavaSDK de PlayFab, necesitará el JavaSDK de cliente de PlayFab y su dependencia, Google GSON.
* Descargue aquí la biblioteca JAR del JavaSDK de cliente de PlayFab.
* Busque `client-sdk-*.jar` y el Java Doc correspondiente si lo necesita.
* Descargue la versión más reciente de Google GSON.
* Busque `gson-*.jar`.
* Tenga a mano los archivos .jar mencionados anteriormente.
Empiece por crear un proyecto normal de Android Studio.
* Compruebe que el **nombre de paquete** coincide con el que ha usado a lo largo de este tutorial (en Firebase, por ejemplo).
Para los fines de *este* ejemplo, usamos **com.foo.playfab.app**, pero recuerde idear su propio nombre de paquete y título mientras sigue este tutorial.
* Seleccione el **SDK mínimo** de su elección.
* A continuación, seleccione el botón **Next**.
Para este tutorial, sugerimos usar la plantilla **Empty Activity** para empezar.
* Seleccione la plantilla que quiere usar.
* A continuación, seleccione el botón **Next**.
* Configure la plantilla como quiera.
* Seleccione el botón **Finish**.
Una vez que abra el proyecto recién creado:
* Cambie a la pestaña **Project** **(1)**.
En el capítulo anterior, descargó el archivo de configuración `google-services.json` desde la consola de Firebase. Úselo para el paso siguiente.
* Compruebe que este archivo se encuentra en la carpeta **App** **(2)**.
* A continuación, vaya a **Tools (3)**.
* Seleccione **Firebase (4)**, como se muestra en el ejemplo proporcionado a continuación.
El **Asistente de Firebase** se abrirá en el lado derecho de la ventana.
* Busque la carpeta **Cloud Messaging** y seleccione **Set up Firebase Cloud Messaging**, como se muestra a continuación.
* En el **Asistente de notificaciones de Firebase**, seleccione el botón **Add FCM to your app (1)**, como se muestra en la imagen siguiente.
* Se abrirá un cuadro de diálogo que indica que se agregarán nuevas dependencias mediante **Gradle**.
* Seleccione **Accept Changes (2)** para aceptar los cambios.
Desafortunadamente, las dependencias que agrega automáticamente el proceso de sincronización de **Gradle** (**3**) son incorrectas y notificarán un error.
* Para configurar las dependencias correctamente, reemplace las líneas agregadas automáticamente por las siguientes:
`implementation 'com.google.firebase:firebase-core:16.0.3`\
`implementation 'com.google.firebase:firebase-messaging:17.0.0`
Una vez completado ese proceso:
* Compruebe que el **Asistente de notificaciones de Firebase** indica que las dependencias ahora están configuradas correctamente **(1)**.
Al principio de este capítulo, adquirimos los archivos JAR necesarios. Normalmente, el archivo de compilación captura estos archivos automáticamente.
* Para asegurarse de que estos archivos JAR aparecen en la carpeta **app/libs** **(2)**, seleccione todos los archivos y haga clic con el botón derecho en ellos.
* A continuación, elija **Add as library... (3)**, como se muestra en el ejemplo proporcionado a continuación.
* Con el [generador de iconos de notificación](https://romannurik.github.io/AndroidAssetStudio/icons-notification.html) de Android Asset Studio, prepare los iconos y colóquelos dentro de **app/src/main/res**.
* En el ejemplo que se muestra a continuación, el icono se denomina **ic\_stat\_blur\_on**.
* Por último, seleccione **Rebuild Project**.
Ahora podemos empezar a implementar el código para recibir y controlar las notificaciones. Vamos a modificar (y crear si es necesario) 4 archivos:
1. **app/src/main/AndroidManifest.xml**
2. **app/src/main/java/..packagePath../MainActivity.java**
3. **app/src/main/java/..packagePath../FooAppFirebaseInstanceIdService.java**
4. **app/src/main/java/..packagePath../FooAppFirebaseMessagingService.java**
La implementación actual está pensada para ser lo más corta posible, solo para probar rápidamente las notificaciones. Considere las [guías de FCM](https://firebase.google.com/docs/cloud-messaging/concept-options) para conocer procedimientos recomendados de alta calidad y ejemplos de implementación más complejos.
#### AndroidManifest.xml
En el código siguiente, reemplace los marcadores de posición `MY_PACKAGE_IDENTIFIER` por su *propio* identificador de paquete.
```xml theme={null}
```
#### MainActivity.java
Los siguientes marcadores de posición del código deben reemplazarse según su escenario.
* `PLAYFAB_TITLE_ID`
* Use el identificador de su título que recibió en Game Manager de PlayFab.
* `PACKAGE_IDENTIFIER`
* Use el identificador de paquete de Java que coincida con su configuración.
```java theme={null}
package PACKAGE_IDENTIFIER;
import android.os.AsyncTask;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.util.Log;
import com.playfab.PlayFabClientAPI;
import com.playfab.PlayFabClientModels.*;
import com.playfab.PlayFabErrors;
import com.playfab.PlayFabSettings;
import java.util.List;
import java.util.Map;
public class MainActivity extends AppCompatActivity {
// Invoked when activity is started
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// Set PlayFab title
PlayFabSettings.TitleId = "PLAYFAB_TITLE_ID";
// Start login operation
AsyncTask.execute(new Runnable() {
@Override
public void run() {
if(login()) FooAppFirebaseInstanceIdService.setAllowRegisterForPush(true); // Ready to register for push notifications
}
});
}
public boolean login(){
LoginWithAndroidDeviceIDRequest request = new LoginWithAndroidDeviceIDRequest();
request.CreateAccount = true;
// There are several approaches on getting unique android device id.
// https://stackoverflow.com/questions/2785485/is-there-a-unique-android-device-id
request.AndroidDeviceId = "qwerty";
PlayFabErrors.PlayFabResult response = PlayFabClientAPI.LoginWithAndroidDeviceID(request);
if(response.Error != null){
Log.d("Foo PlayFab App",CompileErrorsFromResult(response.Error));
return false;
}
return true;
}
// Utility method to compose an error message out of PlayFab result.
private static String CompileErrorsFromResult(PlayFabErrors.PlayFabError error) {
if (error == null)
return null;
String errorMessage = "";
if (error.errorMessage != null)
errorMessage += error.errorMessage;
if (error.errorDetails != null)
for (Map.Entry> pair : error.errorDetails.entrySet())
for (String msg : pair.getValue())
errorMessage += "\n" + pair.getKey() + ": " + msg;
return errorMessage;
}
}
```
#### FooAppFirebaseInstanceIdService.java
El marcador de posición del código que se muestra a continuación debe reemplazarse según su escenario.
* `PACKAGE_IDENTIFIER`
* El identificador de paquete de Java que coincida con su configuración.
```java theme={null}
package PACKAGE_IDENTIFIER;
import android.text.TextUtils;
import android.util.Log;
import com.google.firebase.iid.FirebaseInstanceId;
import com.google.firebase.iid.FirebaseInstanceIdService;
import com.playfab.PlayFabClientAPI;
import com.playfab.PlayFabClientModels;
import com.playfab.PlayFabErrors;
import java.util.List;
import java.util.Map;
public class FooAppFirebaseInstanceIdService extends FirebaseInstanceIdService {
private static String _token;
private static boolean _allowRegistration;
// This is invoked from activity that performs authentication.
// Once login is complete this method is invoked.
// If we have a pending token, we use it to register for push notifications
public static void setAllowRegisterForPush(boolean isAllowed) {
_allowRegistration = isAllowed;
if (_allowRegistration && !TextUtils.isEmpty(_token)) {
registerForPush(_token);
}
}
// Invoked when firebase has fetched a token
// If we already have logged in, we use new token to register for push
@Override
public void onTokenRefresh() {
_token = FirebaseInstanceId.getInstance().getToken();
if (_allowRegistration && !TextUtils.isEmpty(_token)) {
registerForPush(_token);
}
}
private static void registerForPush(String token) {
PlayFabClientModels.AndroidDevicePushNotificationRegistrationRequest request = new PlayFabClientModels.AndroidDevicePushNotificationRegistrationRequest();
request.DeviceToken = token;
PlayFabErrors.PlayFabResult response = PlayFabClientAPI.AndroidDevicePushNotificationRegistration(request);
if (response.Error != null) {
Log.d("Foo PlayFab App", CompileErrorsFromResult(response.Error));
}
}
// Utility method to compose an error message out of PlayFab result.
private static String CompileErrorsFromResult(PlayFabErrors.PlayFabError error) {
if (error == null)
return null;
String errorMessage = "";
if (error.errorMessage != null)
errorMessage += error.errorMessage;
if (error.errorDetails != null)
for (Map.Entry> pair : error.errorDetails.entrySet())
for (String msg : pair.getValue())
errorMessage += "\n" + pair.getKey() + ": " + msg;
return errorMessage;
}
}
```
#### FooAppFirebaseMessagingService.java
El marcador de posición del código que se muestra a continuación debe reemplazarse según su escenario.
* `PACKAGE_IDENTIFIER`
* El identificador de paquete de Java que coincida con su configuración.
```java theme={null}
package com.foo.playfab.app;
import android.util.Log;
import com.google.firebase.messaging.FirebaseMessagingService;
import com.google.firebase.messaging.RemoteMessage;
public class FooAppFirebaseMessagingService extends FirebaseMessagingService {
@Override
public void onMessageReceived(RemoteMessage message) {
// Intercept the message here
Log.d("Foo PlayFab App","Message received: "+message.getNotification().getBody());
}
}
```
## Pruebas
En este punto, debería poder implementar la aplicación en el dispositivo.
* Una vez que inicie la aplicación, esta iniciará sesión automáticamente y se registrará para las notificaciones push.
* Seleccione el botón **Inicio** de su dispositivo para minimizar la aplicación. *Esto es importante*, ya que nos permite probar la notificación que llega a la bandeja del sistema.
* A continuación, vaya a la página de Game Manager de su título de PlayFab y use el panel para localizar el **registro push** más reciente.
* Seleccione el **identificador del jugador (1)**.
Esto abrirá una página **Send Push Notification** para ese jugador.
* Seleccione el botón **Send Push Notification** **(1)**.
* Escriba el **título (2)**.
* Escriba el cuerpo de su mensaje **(3)**.
* Confirme los cambios seleccionando el botón **Send Push Notification** **(4)**.
* Compruebe que el mensaje llega a su dispositivo.
Si su mensaje llega, los mensajes se están entregando correctamente en su aplicación.
En este punto, la integración se ha realizado correctamente. Puede usar **FooAppFirebaseMessagingService** para controlar el mensaje entrante mientras su aplicación se está ejecutando realmente.
## Related topics
- [Notificaciones push para Android](/es/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/push-notifications-for-android.md)
- [Notificaciones push](/es/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/index.md)
- [Plantillas de notificaciones push](/es/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/push-notification-templates.md)
- [Inicio rápido de notificaciones push](/es/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/quickstart.md)
- [Introducción a Android](/es/services/playfab/multiplayer/networking/android-specific-requirements.md)