Este guia descreve como integrar avaliações no app usando o Unreal Engine. Há guias de integração separados para o uso de Kotlin ou Java, código nativo ou Unity.
Visão geral do SDK da Unreal Engine
A API Play In-App Reviews faz parte da família do SDK do Play Core. A API para Unreal
Engine oferece uma classe UInAppReviewsManager para solicitar e iniciar o fluxo
usando os métodos RequestReviewFlow e LaunchReviewFlow. Depois que uma solicitação é
feita, o app pode verificar o status dela usando
EInAppReviewErrorCode.
Versões compatíveis do Unreal Engine
O plug-in é compatível com o Unreal Engine 5.0 e todas as versões mais recentes.
Configurar o ambiente de desenvolvimento
Faça o download do plug-in do Play para Unreal Engine no repositório do GitHub.
Copie a pasta
GooglePlaypara dentro da pastaPluginsno projeto do Unreal Engine.Abra o projeto do Unreal Engine e clique em Edit → Plugins.
Pesquise Google Play e marque a caixa de seleção Ativado.
Reinicie o projeto de jogo e acione um build.
Abra o arquivo
Build.csdo projeto e adicione o móduloPlayInAppReviewsaPublicDependencyModuleNames:using UnrealBuildTool; public class MyGame : ModuleRules { public MyGame(ReadOnlyTargetRules Target) : base(Target) { // ... PublicDependencyModuleNames.Add("PlayInAppReviews"); // ... } }
Solicitar o fluxo de avaliação no app
Siga as orientações sobre quando solicitar avaliações no app para determinar bons pontos no fluxo do usuário para solicitar uma avaliação (por exemplo, depois que um usuário dispensar a tela de resumo ao final de um nível em um jogo). Quando
o app se aproximar de um desses pontos, use UInAppReviewsManager para criar
uma operação, como mostrado no exemplo a seguir:
MyClass.h
void MyClass::OnReviewOperationCompleted(EInAppReviewErrorCode ErrorCode)
{
// ...
}
MyClass.cpp
void MyClass::RequestReviewFlow()
{
// Create a delegate to bind the callback function.
FReviewOperationCompletedDelegate Delegate;
// Bind the completion handler (OnReviewOperationCompleted) to the delegate.
Delegate.BindDynamic(this, &MyClass::OnReviewOperationCompleted);
// Initiate the review flow, passing the delegate to handle the result.
GetGameInstance()
->GetSubsystem<UInAppReviewsManager>()
->RequestReviewFlow(Delegate);
}
O método cria um
FRreviewOperationCompletedDelegatepara processar a conclusão da operação de avaliação.O delegado é vinculado ao método
OnReviewOperationCompleted, que será chamado quando a operação for concluída.A função
BindDynamicgarante que o delegado esteja devidamente vinculado ao retorno de chamada.O método
RequestReviewFlow(Delegate)inicia o processo de avaliação, transmitindo o delegado para processar o resultado.A operação de avaliação é executada de forma assíncrona, permitindo que outras tarefas no app continuem enquanto ela é concluída.
Quando a operação é concluída, o callback
OnReviewOperationCompletedprocessa o resultado, incluindo sucesso ou falha.
Iniciar o fluxo de avaliação no app
Depois que a operação RequestReviewFlow for concluída, você poderá iniciar o fluxo de avaliação
no app. Para isso, vincule um delegado para processar o evento de conclusão,
garantindo que o app reaja ao resultado (sucesso ou falha) da solicitação
de avaliação.
MyClass.h
void MyClass::OnReviewOperationCompleted(EInAppReviewErrorCode ErrorCode)
{
// ...
}
MyClass.cpp
void MyClass::LaunchReviewFlow()
{
// Create a delegate to bind the callback function.
FReviewOperationCompletedDelegate Delegate;
// Bind the completion handler (OnReviewOperationCompleted) to the delegate.
Delegate.BindDynamic(this, &MyClass::OnReviewOperationCompleted);
// Launch the review flow, passing the delegate to handle the result.
GetGameInstance()
->GetSubsystem<UInAppReviewsManager>()
->LaunchReviewFlow(Delegate);
}
Próximas etapas
Teste o fluxo de avaliações no app para verificar se a integração está funcionando corretamente.