/// <summary>
/// Initializes a new instance of the XboxItem class.
/// </summary>
/// <param name="console">The console that this item is associated with.</param>
internal XboxItem(XboxConsole console)
{
if (console == null)
{
throw new ArgumentNullException("console");
}
this.Console = console;
}
/// <summary>
/// Initializes a new instance of the XboxUser class.
/// </summary>
/// <param name="console">The XboxConsole on which the virtual user was created.</param>
/// <param name="userData">The user data of the user.</param>
internal XboxUser(XboxConsole console, XboxUserDefinition userData)
: base(console)
{
if (userData == null)
{
throw new ArgumentNullException("userData", "userData can't be null");
}
this.Definition = userData;
}
/// <summary>
/// Initializes a new instance of the XboxProcess class.
/// </summary>
/// <param name="definition">An object that defines this XboxProcess.</param>
/// <param name="console">The console that this XboxProcess is associated with.</param>
internal XboxProcess(XboxProcessDefinition definition, XboxConsole console)
: base(console)
{
if (definition == null)
{
throw new ArgumentNullException("definition");
}
this.Definition = definition;
}
/// <summary>
/// Initializes a new instance of the XboxPackage class.
/// </summary>
/// <param name="definition">An object that defines this package.</param>
/// <param name="console">The console that this package is associated with.</param>
internal XboxPackage(XboxPackageDefinition definition, XboxConsole console)
: base(console)
{
if (definition == null)
{
throw new ArgumentNullException("definition");
}
this.Definition = definition;
this.Applications = definition.ApplicationDefinitions.Select(appDef => new XboxApplication(appDef, this, console));
}
/// <summary>
/// Runs an executable on the Xbox.
/// </summary>
/// <param name="console">The console to run the executable on.</param>
/// <param name="fileName">The path to an executable to start.</param>
/// <param name="arguments">The command-line arguments to pass into the executable.</param>
/// <param name="operatingSystem">The <see cref="Microsoft.Internal.GamesTest.Xbox.XboxOperatingSystem"/> to run the executable on.</param>
/// <param name="outputReceivedCallback">A callback method that will be called when there is output from the process.</param>
public static void Run(XboxConsole console, string fileName, string arguments, XboxOperatingSystem operatingSystem, Action <string> outputReceivedCallback)
{
if (console == null)
{
throw new ArgumentNullException("console");
}
if (console.IsDisposed)
{
throw new ObjectDisposedException("console");
}
if (string.IsNullOrEmpty(fileName))
{
throw new ArgumentException("fileName is not valid", "fileName");
}
console.Adapter.RunExecutable(console.SystemIpAddressAndSessionKeyCombined, fileName, arguments, operatingSystem, outputReceivedCallback);
}
/// <summary>
/// Gets the remote party associated with a specified Party ID.
/// </summary>
/// <param name="console">The XboxConsole object that this object will be associated with.</param>
/// <param name="partyId">Unique identifier of a party created on another console.</param>
/// <returns>The remote party object which can be passed into other functions.</returns>
public static XboxRemoteParty FromPartyId(XboxConsole console, string partyId)
{
return(new XboxRemoteParty(console, partyId));
}
/// <summary>
/// Initializes a new instance of the <see cref="XboxRemoteParty"/> class.
/// </summary>
/// <param name="console">The XboxConsole object that this object will be associated with.</param>
/// <param name="initPartyId">Remote party ID to initialize with.</param>
internal XboxRemoteParty(XboxConsole console, string initPartyId)
: base(console)
{
this.partyId = initPartyId;
}
/// <summary>
/// Creates a new instance of the <see cref="XboxRemoteUser"/> class.
/// </summary>
/// <param name="console">The XboxConsole object that this object will be associated with.</param>
/// <param name="xuid">A unique Xbox Live identifier for the user.</param>
/// <returns>A new instance of XboxRemoteUser.</returns>
public static XboxRemoteUser FromXuid(XboxConsole console, string xuid)
{
return(new XboxRemoteUser(console, xuid));
}
/// <summary>
/// Initializes a new instance of the <see cref="XboxRemoteUser"/> class.
/// </summary>
/// <param name="console">The XboxConsole object that this object will be associated with.</param>
/// <param name="xuid">The unique Xbox Live identifier to initialize with.</param>
internal XboxRemoteUser(XboxConsole console, string xuid)
: base(console)
{
this.userXuid = xuid;
}
/// <summary>
/// Initializes a new instance of the <see cref="XboxPartyBase"/> class.
/// </summary>
/// <param name="console">The XboxConsole object that the party object is associated with.</param>
internal XboxPartyBase(XboxConsole console)
: base(console)
{
}
/// <summary>
/// Initializes a new instance of the XboxUser class.
/// </summary>
/// <param name="console">The XboxConsole on which the virtual user was created.</param>
/// <param name="userId">A unique identifier for the user.</param>
/// <param name="emailAddress">The email address used to sign the user in.</param>
/// <param name="gamertag">The user's GamerTag.</param>
/// <param name="signedin">If true, the user is signed in on the console.</param>
internal XboxUser(XboxConsole console, uint userId, string emailAddress, string gamertag, bool signedin)
: this(console, userId, emailAddress, gamertag, signedin, false, null)
{
}
/// <summary>
/// Initializes a new instance of the XboxUser class.
/// </summary>
/// <param name="console">The XboxConsole on which the virtual user was created.</param>
/// <param name="userId">A unique identifier for the user.</param>
/// <param name="emailAddress">The email address used to sign the user in.</param>
/// <param name="gamertag">The user's GamerTag.</param>
/// <param name="signedin">If true, the user is signed in on the console.</param>
/// <param name="autoSignIn">If true, the user is setup for automatic sign in on the console.</param>
/// <param name="xuid">The unique Xbox Live identifier for the user.</param>
internal XboxUser(XboxConsole console, uint userId, string emailAddress, string gamertag, bool signedin, bool autoSignIn, string xuid)
: base(console)
{
this.Definition = new XboxUserDefinition(userId, emailAddress, gamertag, signedin, autoSignIn, xuid);
}
/// <summary>
/// Initializes a new instance of the XboxApplication class.
/// </summary>
/// <param name="definition">An object that defines this application.</param>
/// <param name="package">The package that this application is associated with.</param>
/// <param name="console">The console that this application is associated with.</param>
internal XboxApplication(XboxApplicationDefinition definition, XboxPackage package, XboxConsole console)
: base(console)
{
if (definition == null)
{
throw new ArgumentNullException("definition");
}
if (package == null)
{
throw new ArgumentNullException("package");
}
this.Definition = definition;
this.Package = package;
}
/// <summary>
/// Runs an executable on the Xbox.
/// </summary>
/// <param name="console">The console to run the executable on.</param>
/// <param name="fileName">The path to an executable to start.</param>
/// <param name="arguments">The command-line arguments to pass into the executable.</param>
/// <param name="operatingSystem">The <see cref="Microsoft.Internal.GamesTest.Xbox.XboxOperatingSystem"/> to run the application on.</param>
public static void Run(XboxConsole console, string fileName, string arguments, XboxOperatingSystem operatingSystem)
{
Run(console, fileName, arguments, operatingSystem, null);
}
/// <summary>
/// Initializes a new instance of the <see cref="XboxParty"/> class.
/// </summary>
/// <param name="console">The console on which the party is to be created.</param>
/// <param name="titleId">The Title ID of the title the party is for.</param>
/// <returns>The XboxParty object which can be used with XboxUser party management functions or to get party members.</returns>
internal XboxParty(XboxConsole console, uint titleId)
: base(console)
{
this.TitleId = titleId;
}
/// <summary>
/// Gets the local party associated with a specified Title ID.
/// Until the party has been created, this object will throw an XboxConsoleException upon use.
/// </summary>
/// <param name="console">The console object on which the title's party has been created.</param>
/// <param name="titleId">Title ID the party is for.</param>
/// <returns>The party object which can be passed into other functions or for getting party members.</returns>
public static XboxParty FromTitleId(XboxConsole console, uint titleId)
{
return(new XboxParty(console, titleId));
}
/// <summary>
/// Initializes a new instance of the <see cref="XboxUserBase"/> class.
/// </summary>
/// <param name="console">The XboxConsole object that this object will be associated with.</param>
internal XboxUserBase(XboxConsole console) : base(console)
{
}