UWP SDK初始化 更新时间：2024-12-31

简介

在接入Miracle Games SDK之前，首先需要进行SDK的初始化，初始化完成后，才可以配合后台系统使用本SDK的全部功能。一般情况下，在进入游戏后即进行SDK初始化。

MGSDK需要网络权限来请求MG服务器。MG服务器域名为https://api.mguwp.net

CMP

若App集成了广告模块，必须在App启动后，首先调用CMP接口，随后立即调用SDK初始化接口。

SDK初始化

打开App.xaml.cs文件，在类中添加如下方法代码

Public Mainpage（）
{
	try
	{
		This.InitializeComponent（）;
		Load + =（sender，args）=>
		{      	
			 //"YOUR_APP_KEY"参数需要在MG后台申请创建
			 ApplicationManager.OpenCmpAsync("YOUR_APP_KEY");//若App需要集成了MGSDK的广告模块，必须在App启动后，首先调用CMP接口。
			 
			 var result = await MiracleGames.ApplicationManager.SetupAsync("YOUR_APP_KEY");//初始化接口调用
			 
			 if (!result.ReturnValue)//初始化回调接口，检测是否初始化完成。初始化完成之后才可以进行MGSDK中其他功能的调用
				 return;
		};
	}
	catch (Exception){}//添加异常处理机制，预防游戏崩溃.
}

MainPage :: MainPage（）
{
	InitializeComponent（）;    
	try
	{
		Loaded += ref new RoutedEventHandler([this](Object^, RoutedEventArgs^)
		{
			//"YOUR_APP_KEY"参数需要在MG后台申请创建
			MiracleGames::ApplicationManager::OpenCmpAsync(L"YOUR_APP_KEY");//若App需要集成了MGSDK的广告模块，必须在App启动后，首先调用CMP接口。
	
			concurrency::create_task(MiracleGames::ApplicationManager::SetupAsync(L"YOUR_APP_KEY")).then([this](MiracleGames::Services::Core::Common::AsyncProcessResult^ result)//初始化接口调用
			{
				if (!result->ReturnValue)//初始化回调接口，检测是否初始化完成。初始化完成之后才可以进行MGSDK中其他功能的调用
					return;               
			  
			});
		});
	}
	catch (...){}//添加异常处理机制，预防游戏崩溃.
}

或者在MainPage.xaml.cpp里的MainPage()方法里声明初始化方法

if (!MiracleGames::ApplicationManager::SetupCompletedSuccessfully)
{    
	try
	{
		//"YOUR_APP_KEY"参数需要在MG后台申请创建
		MiracleGames::ApplicationManager::OpenCmpAsync(L"YOUR_APP_KEY");//若App需要集成了MGSDK的广告模块，必须在App启动后，首先调用CMP接口。
		
		auto initTask = Concurrency::create_task(MiracleGames::ApplicationManager::SetupAsync(L"YOUR_APP_KEY"));//初始化接口调用
		initTask.then([](MiracleGames::Services::Core::Common::AsyncProcessResult^ result)
		{	
		if (!result->ReturnValue)//初始化回调接口，检测是否初始化完成。初始化完成之后才可以进行MGSDK中其他功能的调用
			  return;             
		});
	}
	catch (...){}//添加异常处理机制，预防游戏崩溃.
}

	

MG 消息推送

旧版本中消息推送需要手动推送,新版本中已经自动融合所以已经不需要调用.

没有初始化成功的错误可能如下

• 网络故障，没有正确的网络支持
• 本SDK不支持VPN，本机开启了VPN软件
• AppKey错误，请登录开发者后台检查应用设置
• 服务器问题，请检查result的错误信息，及时联系技术支持

视频演示--初始化