Começar a usar a atividade em tempo real

Com a API HTTP v1 Firebase Cloud Messaging, é possível enviar, atualizar e encerrar remotamente as notificações de atividade em tempo real em dispositivos iOS. Você precisa do iOS 16.1 para usar a atividade em tempo real e do iOS 17.2 para iniciar remotamente uma notificação de atividade em tempo real.

Antes de começar

Antes de começar a usar a atividade em tempo real no Firebase Cloud Messaging, siga as instruções em Configurar um app cliente do Firebase Cloud Messaging em plataformas da Apple para criar e adicionar Firebase Cloud Messaging ao app cliente.

Iniciar uma atividade em tempo real

Para iniciar uma atividade ao vivo remotamente usando Firebase Cloud Messaging, é necessário receber um token push-to-start da Apple. Você também vai precisar do token de registro FCM para o app de destino.

Para criar um payload que inicia uma atividade ao vivo, preencha o campo apns.payload do exemplo de código abaixo para iniciar remotamente uma atividade ao vivo usando FCM.

REST

{
"message": {
  "token": "FCM_TOKEN",
  "apns": {
    "live_activity_token": "LIVE_ACTIVITY_PUSH_TO_START_TOKEN",
    "headers": {
      "apns-priority": "10"
    },
    "payload": {
      "aps": {
        "timestamp": TIMESTAMP,
        "event": "start",
        "content-state": {
          "demo": 1
        },
        "attributes-type": "DemoAttributes",
        "attributes": {
          "demoAttribute": 1
        },
        "alert": {
          "title": "test title",
          "body": "test body"
        }
      }
    }
  }
}
}

cURL

curl -X POST -H "Authorization: Bearer OAUTH2_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
"message": {
"token": "FCM_TOKEN",
"apns": {
  "live_activity_token": "LIVE_ACTIVITY_PUSH_TO_START_TOKEN",
  "headers": {
    "apns-priority": "10"
  },
  "payload": {
    "aps": {
      "timestamp": TIMESTAMP,
      "event": "start",
      "content-state": {
        "demo": 1
      },
      "attributes-type": "DemoAttributes",
      "attributes": {
        "demoAttribute": 1
      },
      "alert": {
        "title": "test title",
        "body": "test body"
      }
    }
  }
}
}
}' https://fcm.googleapis.com/v1/projects/YOUR_PROJECT_ID/messages:send

Executar

Clique em Executar para testar a amostra no APIs Explorer.

Atualizar uma atividade em andamento

Para atualizar uma atividade ativa remotamente usando Firebase Cloud Messaging, é necessário receber um token de push da Apple. Você também vai precisar do token de registro FCM para o app de destino.

Para criar um payload que atualiza uma atividade ao vivo, preencha o campo apns.payload do exemplo de código abaixo para atualizar remotamente uma atividade ao vivo usando FCM.

REST

{
"message": {
  "token": "FCM_TOKEN",
  "apns": {
    "live_activity_token": "LIVE_ACTIVITY_PUSH_TOKEN",
    "headers": {
      "apns-priority": "10"
    },
    "payload": {
      "aps": {
        "timestamp": TIMESTAMP,
        "event": "update",
        "content-state": {
          "test1": 100,
          "test2": "demo"
        },
        "alert": {
          "title": "test title",
          "body": "test body"
        }
      }
    }
  }
}
}

cURL

curl -X POST -H "Authorization: Bearer OAUTH2_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
"message": {
"token": "FCM_TOKEN",
"apns": {
  "live_activity_token": "LIVE_ACTIVITY_PUSH_TOKEN",
  "headers": {
    "apns-priority": "10"
  },
  "payload": {
    "aps": {
      "timestamp": TIMESTAMP,
      "event": "update",
      "content-state": {
        "test1": 100,
        "test2": "demo"
      },
      "alert": {
        "title": "test title",
        "body": "test body"
      }
    }
  }
}
}
}' https://fcm.googleapis.com/v1/projects/YOUR_PROJECT_ID/messages:send

Executar

Clique em Executar para testar a amostra no APIs Explorer.

Encerrar uma atividade em tempo real

Para encerrar uma atividade ao vivo usando Firebase Cloud Messaging, é necessário receber um token de push da Apple. Você também vai precisar do token de registro FCM do app de destino.

Para criar um payload que encerra uma atividade ao vivo, preencha o campo apns.payload do exemplo de código abaixo para encerrar remotamente uma atividade ao vivo usando FCM.

REST

{
"message": {
  "token": "FCM_TOKEN",
  "apns": {
    "live_activity_token": "LIVE_ACTIVITY_PUSH_TOKEN",
    "headers": {
      "apns-priority": "10"
    },
    "payload": {
      "aps": {
        "timestamp": TIMESTAMP,
        "dismissal-date": DISMISSAL_DATE,
        "event": "end",
        "content-state": {
          "test1": 100,
          "test2": "demo"
        },
        "alert": {
          "title": "test title",
          "body": "test body"
        }
      }
    }
  }
}
}

cURL

curl -X POST -H "Authorization: Bearer OAUTH2_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
"message": {
"token": "FCM_TOKEN",
"apns": {
  "live_activity_token": "LIVE_ACTIVITY_PUSH_TOKEN",
  "headers": {
    "apns-priority": "10"
  },
  "payload": {
    "aps": {
      "timestamp": TIMESTAMP,
      "dismissal-date": DISMISSAL_DATE,
      "event": "end",
      "content-state": {
        "test1": 100,
        "test2": "demo"
      },
      "alert": {
        "title": "test title",
        "body": "test body"
      }
    }
  }
}
}
}' https://fcm.googleapis.com/v1/projects/YOUR_PROJECT_ID/messages:send

Executar

Clique em Executar para testar a amostra no APIs Explorer.