Engine.UIAction_ShowDeviceSelectionUI

/**
 * This action tells the online subsystem to show the marketplace ui for content
 *
 * Copyright 1998-2008 Epic Games, Inc. All Rights Reserved.
 */
class UIAction_ShowDeviceSelectionUI extends UIAction
	native(inherit);

// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)

/** The amount of data that is going to be written */
var() int SizeNeeded;

/** Whether the UI should always be displayed or not */
var() bool bForceShowUI;

/** Will hold the resultant value the user input */
var() int DeviceID;

/** The name of the device that was selected */
var() string DeviceName;

/** Whether the async call is done or not */
var bool bIsDone;

/** Whether the user chose a device or cancelled the dialog. */
var bool bResult;

/** Writes the current DeviceID to all connected variables. */
native function WriteToVariables();

/**
 * Uses the online subsystem to show the device selection UI
 */
event SelectDevice()
{
	local OnlineSubsystem OnlineSub;
	local OnlinePlayerInterfaceEx PlayerIntEx;

	OnlineSub = class'GameEngine'.static.GetOnlineSubsystem();
	if (OnlineSub != None)
	{
		PlayerIntEx = OnlineSub.PlayerInterfaceEx;
		if (PlayerIntEx != None)
		{
			// Register our callback
			PlayerIntEx.AddDeviceSelectionDoneDelegate(class'UIInteraction'.static.GetPlayerControllerId(PlayerIndex),OnDeviceSelectionComplete);
			// Show the UI
			if (PlayerIntEx.ShowDeviceSelectionUI(class'UIInteraction'.static.GetPlayerControllerId(PlayerIndex),SizeNeeded,bForceShowUI) == false)
			{
				// Don't wait if there was an error
				LogInternal("Error occured while trying to display device selection UI");
				PlayerIntEx.ClearDeviceSelectionDoneDelegate(class'UIInteraction'.static.GetPlayerControllerId(PlayerIndex),OnDeviceSelectionComplete);
				bIsDone = true;
			}
		}
		else
		{
			// Don't wait if there was an error
			bIsDone = true;
			LogInternal("No OnlinePlayerInterfaceEx present to display the device selection UI");
		}
	}
	// if we do not have an Online SubSystem then we can just return true
	else
	{
		bIsDone = true;
	}
}

/**
 * Reads the results of the user's device choice
 *
 * @param bWasSuccessful true if the action completed without error, false if there was an error
 */
function OnDeviceSelectionComplete(bool bWasSuccessful)
{
	local OnlineSubsystem OnlineSub;
	local OnlinePlayerInterfaceEx PlayerIntEx;

	OnlineSub = class'GameEngine'.static.GetOnlineSubsystem();
	if (OnlineSub != None)
	{
		PlayerIntEx = OnlineSub.PlayerInterfaceEx;
		if (PlayerIntEx != None)
		{
			// Unregister our callback
			PlayerIntEx.ClearDeviceSelectionDoneDelegate(class'UIInteraction'.static.GetPlayerControllerId(PlayerIndex),OnDeviceSelectionComplete);
			// Don't read the information unless it was successful
			if (bWasSuccessful == true)
			{
				// Read the per user results
				DeviceID = PlayerIntEx.GetDeviceSelectionResults(class'UIInteraction'.static.GetPlayerControllerId(PlayerIndex),DeviceName);
				WriteToVariables();
				bResult = true;
			}
		}
	}

	LogInternal("Device Result: " $ bWasSuccessful);
	bIsDone = true;
	
}

defaultproperties
{
   bLatentExecution=True
   bAutoActivateOutputLinks=False
   OutputLinks(0)=(LinkDesc="Failure")
   OutputLinks(1)=(LinkDesc="Success")
   VariableLinks(0)=(ExpectedType=Class'Engine.SeqVar_String',LinkDesc="Device Name",PropertyName="DeviceName",bWriteable=True)
   VariableLinks(1)=(LinkDesc="DeviceID",PropertyName="DeviceID")
   ObjName="Select Media Device"
   ObjCategory="Online"
   Name="Default__UIAction_ShowDeviceSelectionUI"
   ObjectArchetype=UIAction'Engine.Default__UIAction'
}