102 lines
4.3 KiB
C#
102 lines
4.3 KiB
C#
using System;
|
|
using System.Collections.Generic;
|
|
using System.Linq;
|
|
using System.Text;
|
|
using Rssdp.Infrastructure;
|
|
|
|
namespace Rssdp
|
|
{
|
|
/// <summary>
|
|
/// Allows publishing devices both as notification and responses to search requests.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// This is the 'server' part of the system. You add your devices to an instance of this class so clients can find them.
|
|
/// </remarks>
|
|
public class SsdpDevicePublisher : SsdpDevicePublisherBase
|
|
{
|
|
|
|
#region Constructors
|
|
|
|
/// <summary>
|
|
/// Default constructor.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// <para>Uses the default <see cref="ISsdpCommunicationsServer"/> implementation and network settings for Windows and the SSDP specification.</para>
|
|
/// </remarks>
|
|
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Reliability", "CA2000:Dispose objects before losing scope", Justification = "No way to do this here, and we don't want to dispose it except in the (rare) case of an exception anyway.")]
|
|
public SsdpDevicePublisher()
|
|
: this(new SsdpCommunicationsServer(new SocketFactory(null)))
|
|
{
|
|
|
|
}
|
|
|
|
/// <summary>
|
|
/// Full constructor.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// <para>Allows the caller to specify their own <see cref="ISsdpCommunicationsServer"/> implementation for full control over the networking, or for mocking/testing purposes..</para>
|
|
/// </remarks>
|
|
public SsdpDevicePublisher(ISsdpCommunicationsServer communicationsServer)
|
|
: base(communicationsServer, GetOSName(), GetOSVersion())
|
|
{
|
|
|
|
}
|
|
|
|
/// <summary>
|
|
/// Partial constructor.
|
|
/// </summary>
|
|
/// <param name="localPort">The local port to use for socket communications, specify 0 to have the system choose it's own.</param>
|
|
/// <remarks>
|
|
/// <para>Uses the default <see cref="ISsdpCommunicationsServer"/> implementation and network settings for Windows and the SSDP specification, but specifies the local port to use for socket communications. Specify 0 to indicate the system should choose it's own port.</para>
|
|
/// </remarks>
|
|
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Reliability", "CA2000:Dispose objects before losing scope", Justification = "No way to do this here, and we don't want to dispose it except in the (rare) case of an exception anyway.")]
|
|
public SsdpDevicePublisher(int localPort)
|
|
: this(new SsdpCommunicationsServer(new SocketFactory(null), localPort))
|
|
{
|
|
|
|
}
|
|
|
|
/// <summary>
|
|
/// Partial constructor.
|
|
/// </summary>
|
|
/// <param name="localPort">The local port to use for socket communications, specify 0 to have the system choose it's own.</param>
|
|
/// <param name="multicastTimeToLive">The number of hops a multicast packet can make before it expires. Must be 1 or greater.</param>
|
|
/// <remarks>
|
|
/// <para>Uses the default <see cref="ISsdpCommunicationsServer"/> implementation and network settings for Windows and the SSDP specification, but specifies the local port to use and multicast time to live setting for socket communications.</para>
|
|
/// <para>Specify 0 for the <paramref name="localPort"/> argument to indicate the system should choose it's own port.</para>
|
|
/// <para>The <paramref name="multicastTimeToLive"/> is actually a number of 'hops' on the network and not a time based argument.</para>
|
|
/// </remarks>
|
|
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Reliability", "CA2000:Dispose objects before losing scope", Justification = "No way to do this here, and we don't want to dispose it except in the (rare) case of an exception anyway.")]
|
|
public SsdpDevicePublisher(int localPort, int multicastTimeToLive)
|
|
: this(new SsdpCommunicationsServer(new SocketFactory(null), localPort, multicastTimeToLive))
|
|
{
|
|
}
|
|
|
|
#endregion
|
|
|
|
#region Private Methods
|
|
|
|
private static string GetOSName()
|
|
{
|
|
#if NET46
|
|
return Environment.OSVersion.Platform.ToString();
|
|
#elif NETSTANDARD1_6
|
|
return System.Runtime.InteropServices.RuntimeInformation.OSDescription;
|
|
#endif
|
|
return "Operating System";
|
|
}
|
|
|
|
private static string GetOSVersion()
|
|
{
|
|
#if NET46
|
|
return Environment.OSVersion.Version.ToString() + " " + Environment.OSVersion.ServicePack.ToString();
|
|
#elif NETSTANDARD1_6
|
|
return System.Runtime.InteropServices.RuntimeInformation.FrameworkDescription;
|
|
#endif
|
|
return "1.0";
|
|
}
|
|
|
|
#endregion
|
|
|
|
}
|
|
} |