2021-05-07 00:39:20 +02:00
|
|
|
#nullable disable
|
|
|
|
|
2020-08-22 21:56:24 +02:00
|
|
|
#pragma warning disable CS1591
|
|
|
|
|
2019-01-13 21:01:16 +01:00
|
|
|
using System;
|
2018-12-28 00:27:57 +01:00
|
|
|
using System.Collections.Generic;
|
2019-07-07 21:03:26 +02:00
|
|
|
using System.Net;
|
2019-01-13 20:25:32 +01:00
|
|
|
using MediaBrowser.Common;
|
|
|
|
using MediaBrowser.Model.System;
|
2020-11-16 18:17:49 +01:00
|
|
|
using Microsoft.AspNetCore.Http;
|
2018-12-28 00:27:57 +01:00
|
|
|
|
|
|
|
namespace MediaBrowser.Controller
|
|
|
|
{
|
|
|
|
/// <summary>
|
2020-06-16 00:37:52 +02:00
|
|
|
/// Interface IServerApplicationHost.
|
2018-12-28 00:27:57 +01:00
|
|
|
/// </summary>
|
|
|
|
public interface IServerApplicationHost : IApplicationHost
|
|
|
|
{
|
2020-09-03 11:54:38 +02:00
|
|
|
bool CoreStartupHasCompleted { get; }
|
|
|
|
|
2018-12-28 00:27:57 +01:00
|
|
|
bool CanLaunchWebBrowser { get; }
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
/// Gets the HTTP server port.
|
|
|
|
/// </summary>
|
|
|
|
/// <value>The HTTP server port.</value>
|
|
|
|
int HttpPort { get; }
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
/// Gets the HTTPS port.
|
|
|
|
/// </summary>
|
|
|
|
/// <value>The HTTPS port.</value>
|
|
|
|
int HttpsPort { get; }
|
2019-01-08 00:27:46 +01:00
|
|
|
|
2018-12-28 00:27:57 +01:00
|
|
|
/// <summary>
|
2020-04-02 23:45:04 +02:00
|
|
|
/// Gets a value indicating whether the server should listen on an HTTPS port.
|
2018-12-28 00:27:57 +01:00
|
|
|
/// </summary>
|
2020-04-02 23:45:04 +02:00
|
|
|
bool ListenWithHttps { get; }
|
2018-12-28 00:27:57 +01:00
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
/// Gets the name of the friendly.
|
|
|
|
/// </summary>
|
|
|
|
/// <value>The name of the friendly.</value>
|
|
|
|
string FriendlyName { get; }
|
|
|
|
|
2021-02-27 14:56:21 +01:00
|
|
|
/// <summary>
|
2021-02-27 18:34:44 +01:00
|
|
|
/// Gets the configured published server url.
|
2021-02-27 14:56:21 +01:00
|
|
|
/// </summary>
|
2021-02-28 11:16:28 +01:00
|
|
|
string PublishedServerUrl { get; }
|
2021-02-27 14:56:21 +01:00
|
|
|
|
2020-08-13 22:10:26 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Gets the system info.
|
|
|
|
/// </summary>
|
2020-09-12 17:41:37 +02:00
|
|
|
/// <param name="source">The originator of the request.</param>
|
2020-08-13 22:10:26 +02:00
|
|
|
/// <returns>SystemInfo.</returns>
|
2020-09-12 17:41:37 +02:00
|
|
|
SystemInfo GetSystemInfo(IPAddress source);
|
2020-08-13 22:10:26 +02:00
|
|
|
|
2020-09-12 17:41:37 +02:00
|
|
|
PublicSystemInfo GetPublicSystemInfo(IPAddress address);
|
2018-12-28 00:27:57 +01:00
|
|
|
|
|
|
|
/// <summary>
|
2020-09-14 16:46:38 +02:00
|
|
|
/// Gets a URL specific for the request.
|
2018-12-28 00:27:57 +01:00
|
|
|
/// </summary>
|
2020-09-14 16:46:38 +02:00
|
|
|
/// <param name="request">The <see cref="HttpRequest"/> instance.</param>
|
|
|
|
/// <param name="port">Optional port number.</param>
|
|
|
|
/// <returns>An accessible URL.</returns>
|
|
|
|
string GetSmartApiUrl(HttpRequest request, int? port = null);
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
/// Gets a URL specific for the request.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="remoteAddr">The remote <see cref="IPAddress"/> of the connection.</param>
|
|
|
|
/// <param name="port">Optional port number.</param>
|
|
|
|
/// <returns>An accessible URL.</returns>
|
|
|
|
string GetSmartApiUrl(IPAddress remoteAddr, int? port = null);
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
/// Gets a URL specific for the request.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="hostname">The hostname used in the connection.</param>
|
|
|
|
/// <param name="port">Optional port number.</param>
|
|
|
|
/// <returns>An accessible URL.</returns>
|
|
|
|
string GetSmartApiUrl(string hostname, int? port = null);
|
2018-12-28 00:27:57 +01:00
|
|
|
|
|
|
|
/// <summary>
|
2020-09-12 17:41:37 +02:00
|
|
|
/// Gets a localhost URL that can be used to access the API using the loop-back IP address.
|
2020-05-10 20:36:11 +02:00
|
|
|
/// over HTTP (not HTTPS).
|
2018-12-28 00:27:57 +01:00
|
|
|
/// </summary>
|
2020-04-17 03:46:49 +02:00
|
|
|
/// <returns>The API URL.</returns>
|
2020-05-11 00:07:56 +02:00
|
|
|
string GetLoopbackHttpApiUrl();
|
2018-12-28 00:27:57 +01:00
|
|
|
|
2020-05-10 20:36:11 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Gets a local (LAN) URL that can be used to access the API.
|
2020-05-13 15:46:29 +02:00
|
|
|
/// Note: if passing non-null scheme or port it is up to the caller to ensure they form the correct pair.
|
2020-05-10 20:36:11 +02:00
|
|
|
/// </summary>
|
|
|
|
/// <param name="hostname">The hostname to use in the URL.</param>
|
|
|
|
/// <param name="scheme">
|
|
|
|
/// The scheme to use for the URL. If null, the scheme will be selected automatically,
|
|
|
|
/// preferring HTTPS, if available.
|
|
|
|
/// </param>
|
|
|
|
/// <param name="port">
|
|
|
|
/// The port to use for the URL. If null, the port will be selected automatically,
|
|
|
|
/// preferring the HTTPS port, if available.
|
|
|
|
/// </param>
|
|
|
|
/// <returns>The API URL.</returns>
|
2020-09-12 17:41:37 +02:00
|
|
|
string GetLocalApiUrl(string hostname, string scheme = null, int? port = null);
|
2018-12-28 00:27:57 +01:00
|
|
|
|
2020-03-15 13:14:57 +01:00
|
|
|
/// <summary>
|
|
|
|
/// Open a URL in an external browser window.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="url">The URL to open.</param>
|
|
|
|
/// <exception cref="NotSupportedException"><see cref="CanLaunchWebBrowser"/> is false.</exception>
|
2018-12-28 00:27:57 +01:00
|
|
|
void LaunchUrl(string url);
|
|
|
|
|
2019-08-09 23:16:24 +02:00
|
|
|
IEnumerable<WakeOnLanInfo> GetWakeOnLanInfo();
|
2018-12-28 00:27:57 +01:00
|
|
|
|
|
|
|
string ExpandVirtualPath(string path);
|
2019-11-24 15:27:58 +01:00
|
|
|
|
2020-09-03 11:32:22 +02:00
|
|
|
string ReverseVirtualPath(string path);
|
2018-12-28 00:27:57 +01:00
|
|
|
}
|
|
|
|
}
|