With the support of xaml in Cocos2d-x wp8，it's much convenient to invoke third SDK. I will show you how to integrate third SDK using Microsoft's advertise system and IAP as a example, integrated in the XAML project.
but this page just show how to add control directly in the xaml page，I will show you how to add control in the c# page by C++ invocation, and how to deal with the C# controls response and call back in c++, that is c++ and c# to call each other. The example are all in my own adcontrol branch in github, link:
https://github.com/koowolf/cocos2d-x/tree/adcontrol
http://msdn.microsoft.com/zh-cn/library/windowsphone/develop/jj206949%28v=vs.105%29.aspx
http://msdn.microsoft.com/en-us/library/windowsphone/develop/jj681689%28v=vs.105%29.aspx
I had add an example in myselve's adcontrol branch in github, just adding the mock in-app purchase library to my solution, link:
https://github.com/koowolf/cocos2d-x/tree/IAP
detail tutorial as following, the model in AdControl and IAP are nearly the same, so we mostly describe the integrating of the adcontrol.
We use the the following code to show the model, from the link http://stackoverflow.com/questions/17304386/how-does-one-make-function-calls-or-trigger-events-from-a-native-component-into
//.h
[Windows::Foundation::Metadata::WebHostHidden]
public interface class ICallback
{
public:
virtual void Exec( Platform::String ^Command, Platform::String ^Param);
};
//.cpp
ICallback ^CSCallback = nullptr;
void Direct3DInterop::SetCallback( ICallback ^Callback)
{
CSCallback = Callback;
}
//...
if (CSCallback != nullptr)
CSCallback->Exec( "Command", "Param" );
C#
public class CallbackImpl : ICallback
{
public void Exec(String Command, String Param)
{
//Execute some C# code, if you call UI stuff you will need to call this too
//Deployment.Current.Dispatcher.BeginInvoke(() => {
// //Lambda code
//}
}
}
//...
CallbackImpl CI = new CallbackImpl();
D3DComponent.SetCallback( CI);link：http://www.microsoft.com/en-us/download/details.aspx?id=8729
Install the .msi file while download ok. Open HelloCpp project，right click and select "Add Reference", select "Extensions" in Reference Mangager like as following:
find Solution Explorer=〉Properties，open WMAppManifest.xml
select **Capabilities **，check the item of ID_CAP_IDENTITY_USER, ID_CAP_MEDIALIB_PHOTO, ID_CAP_PHONEDIALER
Add ICallback.h file to HelloCppComponent，and add ICallback interface. Add call back event and invoke interface as following:
namespace PhoneDirect3DXamlAppComponent
{
namespace AdControlHelper
{
// An asynchronous completed event argument
public ref class CompletedEventArgs sealed
{
public:
CompletedEventArgs(bool ReturnValue, int ErrorCode, Platform::String^ ErrorMessage)
{
this->ReturnValue = ReturnValue;
this->ErrorCode = ErrorCode;
this->ErrorMessage = ErrorMessage;
}
property bool ReturnValue;
property int ErrorCode;
property Platform::String^ ErrorMessage;
};
// A callback interface for C# code to implement.
public interface class ICallback
{
// Submit a score completed event.
event Windows::Foundation::EventHandler<CompletedEventArgs^>^ OnBannerRefreshed;
event Windows::Foundation::EventHandler<CompletedEventArgs^>^ OnBannerReceivedFailed;
// switch bottombar in mainpage to add or remove panel
void SwitchBottomBar();
//... other event and other function
};
}
}CompletedEventArgs is the encapsulation of responds information, contain error code and error information. SwitchBottomBar() is the function of c++ invoke c#. OnBannerRefreshed and OnBannerReceivedFailed is call back event handler, invoke in C#, respond such event handler and finish call back.
add AdControlCallback.cs in HelloCpp project, implement AdControlCallback and derive from ICallback interface as following:
namespace PhoneDirect3DXamlAppComponent
{
/// <summary>
/// A callback class that implements the WinRT Component interface ICallback.
/// All methods provided will be called through the ICallback interface in native code.
/// </summary>
public class AdControlCallback : ICallback
{
public event EventHandler<CompletedEventArgs> OnBannerRefreshed;
public event EventHandler<CompletedEventArgs> OnBannerReceivedFailed;
public void SwitchBottomBar()
{
m_MainPage.SwitchBottomBar();
if (bAdCreated == false)
{
CreateBannerAd();
bAdCreated = true;
}
}
//Create the Ad at runtime and add to the container
private void CreateBannerAd()
{
Deployment.Current.Dispatcher.BeginInvoke(() =>
{
// ApplicationID = "test_client", AdUnitID = "Image480_80",
AdControl adControl = new AdControl("test_client", // ApplicationID
"Image480_80", // AdUnitID
true); // isAutoRefreshEnabled
// Make the AdControl size large enough that it can contain the image
adControl.Width = 480;
adControl.Height = 80;
adControl.AdRefreshed += new EventHandler(adControl_AdRefreshed);
adControl.ErrorOccurred += new EventHandler<Microsoft.Advertising.AdErrorEventArgs>(AdView_AdRequestFailed);
m_MainPage.AddBannerAd(adControl);
});
}
private void adControl_AdRefreshed(object sender, EventArgs e)
{
if (OnBannerRefreshed != null && m_d3dInterop != null)
{
m_d3dInterop.OnAdControlEvent(sender, new CompletedEventArgs(true, 200, "Received ad successfully"), OnBannerRefreshed);
}
}
}
}note：
1.AdControl is the class in Microsoft.Advertising.Mobile.UI，you need to add the need namespace: using Microsoft.Advertising.Mobile.UI;.
2.AdControlCallback must derive member function and member variables from ICallback， you can add C# implement in the SwitchBottomBar() function, it call private function CreateBannerAd() to deal with AdControl.
3.you can use Deployment.Current.Dispatcher.BeginInvoke to enclose C# control, let C# control and C++ game interface in the difference thread, so if call thirdSDK with long time respond, it will not slow down the game interface, and if you call any control in MainPage.xaml you must place it in the main thread. We can find from debug that，MainPage.xaml.cs and native c++ interface is in the difference thread，MainPage is in the MainThread，but c++ game interface is working in the worker thread.
4.adControl_AdRefreshed is the response of AdControl，using this responds function we can judge as if we succeed to add the AdControl.
5.we can not directly call C++ method in adControl_AdRefreshed， or we will face with some unexpected errors, because the responds locate in the main thread （as the third point described above）, we need to attention to the problem of thread safe. I will describe how to deal with responds later.
When c++ call SwitchBottomBar() function, we need to adjust the MainPage.xaml page, make it show game UI in the upper place, and show advertisement in the down place. Adjust as following:
open MainPage.xaml page directly, modify code in ContentPanel，add StackPanel，set stackContainer's Visibility property as Collapsed, will add AdControl in stackContainer later.
<!--ContentPanel - place additional content here-->
<Grid x:Name="ContentPanel" Grid.Row="1" Margin="12,0,12,0">
<DrawingSurface x:Name="DrawingSurface" Loaded="DrawingSurface_Loaded" Margin="0,0,0,0" />
<!-- Container where the adcontrol will be added at run time-->
<StackPanel x:Name="stackContainer" Height="0" VerticalAlignment="Bottom" Visibility="Collapsed">
</StackPanel>
</Grid>when add SwitchBottomBar function in MainPage.xaml.cs, will show stackContainer while invoke, we modify the size of DrawingSurface. Add AddBannerAd function, and add AdControl in stackContainer to show.
// add to the container
public void AddBannerAd(AdControl adView)
{
Dispatcher.BeginInvoke(() =>
{
this.stackContainer.Children.Add(adView);
});
}
public void SwitchBottomBar()
{
Dispatcher.BeginInvoke(() =>
{
bool bIsVisible = Visibility.Visible == this.stackContainer.Visibility;
this.stackContainer.Visibility = (bIsVisible ? Visibility.Collapsed : Visibility.Visible);
// reMargin DrawingSurface
Thickness srcMargin = this.DrawingSurface.Margin;
srcMargin.Bottom = bIsVisible ? 0 : 100;
this.DrawingSurface.Margin = srcMargin;
// reHeight stackcontainer
this.stackContainer.Height = bIsVisible ? 0 : 100;
});
}note that SwitchBottomBar() in MainPage.xaml.cs invoked in SwitchBottomBar() in AdControlCallback， we need to add a MainPage instance as a member variable in AdControlCallback class, and set SwitchBottomBar()'s property as public in MainPage.xaml.cs.
add managed class AdControlDelegate in HelloCppComponent，convinent to call between C++ and C#.
namespace PhoneDirect3DXamlAppComponent
{
namespace AdControlHelper
{
public ref class AdControlDelegate sealed
{
public:
AdControlDelegate(void);
void SetCallback(ICallback^ callback);
property static ICallback^ GlobalCallback;
};
}
}we use static instance to save ICallback's instance，SetCallback function invoked in c# code. Set GlobalCallback as callback in SetCallback implement. If we use AdControlDelegate class many time，use singleton to create AdControlDelegate. Call SetCallback in the DrawingSurface_Loaded function in HelloCpp as following:
AdControlDelegate adDelegate = new AdControlDelegate();
AdControlCallback adObj = new AdControlCallback();
adDelegate.SetCallback(adObj);test and call sdk in menuCallbackBottom，implement call back event handler OnBannerReceivedFailed in C# code
AdControlDelegate^ AdControlObj = ref new AdControlDelegate();
AdControlObj->GlobalCallback->OnBannerReceivedFailed += ref new Windows::Foundation::EventHandler<CompletedEventArgs^>(
[this](Platform::Object^ sender, CompletedEventArgs^ args){
Platform::String ^platform_string = args->ErrorMessage;
const wchar_t* wide_chars = platform_string->Data();
char chars[512];
wcstombs(chars, wide_chars, 512);
pResponseLabel->setString(chars);
});
AdControlObj->GlobalCallback->SwitchBottomBar();implement OnBannerReceivedFailed responds in the function and call SwitchBottomBar to invoke C# sdk. Using GlobalCallback to get the instance that created in c# code.
we can use main thread to invoke Sdk and can create a task to invoke too. Like Deployment.Current.Dispatcher.BeginInvoke described above to invoke, Deployment.Current.Dispatcher.BeginInvoke can get the main thread, and call sdk in it. We can use task to call too. As following:
//Create the Ad at runtime and add to the container
public void CreateBannerAd()
{
//common worker thread
System.Threading.Tasks.Task.Run(async () =>
{
// ApplicationID = "test_client", AdUnitID = "Image480_80",
AdControl adControl = new AdControl("test_client", // ApplicationID
"Image480_80", // AdUnitID
true); // isAutoRefreshEnabled
// Make the AdControl size large enough that it can contain the image
adControl.Width = 480;
adControl.Height = 80;
adControl.AdRefreshed += new EventHandler(adControl_AdRefreshed);
adControl.ErrorOccurred += new EventHandler<Microsoft.Advertising.AdErrorEventArgs>(AdView_AdRequestFailed);
m_MainPage.AddBannerAd(adControl);
});
}
It has better to return to the game thread, so we have to deal with the call back.
in the Direct3DInterop implement, we can find that, all the click and keyboard event handle by the mInputEvents queue, just throw event to the thread, and use ProcessEvents function to handle. So we define a AdControlEvent class and derived from InputEvent as following:
namespace PhoneDirect3DXamlAppComponent
{
class AdControlEvent : public InputEvent
{
public:
AdControlEvent(Object^ sender, CompletedEventArgs^ args, Windows::Foundation::EventHandler<CompletedEventArgs^>^ handler);
virtual void execute(Cocos2dRenderer ^ renderer);
private:
Object^ m_sender;
CompletedEventArgs^ m_args;
Windows::Foundation::EventHandler<CompletedEventArgs^>^ m_handler;
};
}
in the constructor in AdControlEvent function, the last param is type of EventHandler，we handle it directly not to use Cocos2dRenderer. As we implement the call back in handler, invoke it in the execute function as following:
void AdControlEvent::execute( Cocos2dRenderer ^ renderer )
{
m_handler->Invoke(m_sender, m_args);
}in the class of Direct3DInterop，add the OnAdControlEvent responds function as following:
void Direct3DInterop::OnAdControlEvent(Object^ sender, CompletedEventArgs^ args, Windows::Foundation::EventHandler<CompletedEventArgs^>^ handler)
{
std::lock_guard<std::mutex> guard(mMutex);
std::shared_ptr<AdControlEvent> e(new AdControlEvent(sender, args, handler));
mInputEvents.push(e);
}according to different implement in different handler instance, just call the only OnAdControlEvent function, such as implement another OnBannerReceivedFailed to invoke. We modify the code in call back function AdView_AdRequestFailed：
private void AdView_AdRequestFailed(object sender, Microsoft.Advertising.AdErrorEventArgs e)
{
//if (OnBannerReceived != null)
//{
// OnBannerReceived(sender, new CompletedEventArgs(true, 200, "Received ad successfully"));
//}
if (OnBannerReceivedFailed != null && m_d3dInterop != null)
{
m_d3dInterop.OnAdControlEvent(sender, new CompletedEventArgs(true, (int)e.ErrorCode, "Received ad failed" + e.Error.Message), OnBannerReceivedFailed);
}
} add SetDirect3DInterop function in AdControlCallback to save the Direct3DInterop instance
public void SetDirect3DInterop(Direct3DInterop d3dInterop)
{
m_d3dInterop = d3dInterop;
}we finish the procedure of call and call back, and if you we want to invoke other XAML page in MainPage, add SetMainPage function in AdControlCallback to save the MainPage instance as following:
public void SetMainPage(MainPage mainPage)
{
m_MainPage = mainPage;
}
private void CallToShowPage()
{
// get the UI thread (ie. the Main Thread) to let the worker thread (ie. opengl thread) work normally.
Deployment.Current.Dispatcher.BeginInvoke(() =>
{
m_MainPage.NavigationService.Navigate(new Uri("/Page1.xaml", UriKind.Relative));
});
}you can add button and use CallToShowPage above to popup a full-screen xaml page.
As an example, I download and add the mock in-app purchase library to solution, following http://msdn.microsoft.com/en-us/library/windowsphone/develop/jj681689%28v=vs.105%29.aspx#IAP_MockLibrary.
Note:
- after download the library, compile it and generate the MockIAPLib.dll file. Add it to HelloCpp as a reference, the result as following:
-
add the StoreFront.xaml and StoreManager.cs and Res resources files to the project.
-
when navigate back from other page like StoreFront.xaml, never use
this.NavigationService.Navigate(new Uri("/PhoneDirect3DXamlAppInterop;component/MainPage.xaml", UriKind.Relative));
because the line above will cause the MainPage.xaml reloading and will result some errors, use this:
this.NavigationService.GoBack();
