C# MAUI - Android 내에 Web 서비스 호스팅
안드로이드 환경에서 Web Server를 호스팅해 볼 텐데요, 마침 이런 글이 있군요.
Running .NET Core Web host and Kestrel server on Xamarin Forms apps
; https://melihercan.medium.com/running-net-core-web-host-and-kestrel-server-on-xamarin-forms-apps-2c5e3a3df5a5
위의 글 내용 자체는 ASP.NET Core를 호스팅하는 것이지만, 일단은 편하게 EmbedIO 패키지를 참조하는 것으로 시작해 보겠습니다.
Install-Package EmbedIO
이후 README 문서에 따라,
unosquare/embedio
; https://github.com/unosquare/embedio/
다음과 같이 MAUI에 코드를 추가하면 됩니다.
using EmbedIO;
using EmbedIO.Actions;
namespace MauiApp1;
public partial class App : Application
{
WebServer? _webServer;
string _url = "http://localhost:9696/";
public App()
{
InitializeComponent();
MainPage = new AppShell();
_webServer = CreateWebServer(_url);
_webServer.RunAsync();
}
private static WebServer CreateWebServer(string url)
{
var server = new WebServer(o => o
.WithUrlPrefix(url)
.WithMode(HttpListenerMode.EmbedIO))
.WithLocalSessionManager()
.WithModule(new ActionModule("/", HttpVerbs.Get, ctx => GetFile(ctx)));
server.StateChanged += (s, e) =>
{
System.Diagnostics.Trace.WriteLine($"WebServer New State - {e.NewState}");
};
return server;
}
private static async Task GetFile(IHttpContext ctx)
{
await ctx.SendDataAsync(new { Message = "Test" });
}
}
Emulator에 실행시키면 이제 http:9696으로 웹 서비스를 하게 되는데요, 테스트를 위해 Emulator를 호스팅하는 측에서 adb.exe로 port forward 설정을 하고,
adb forward tcp:9696 tcp:9696
웹 브라우저를 이용해 "
http://localhost:9696" 링크를 방문하면 화면에 다음과 같은 반환 결과를 볼 수 있습니다.
{
"Message": "Test"
}
간단하죠? ^^
혹시, 저 웹 서버로 MAUI
MediaElement의 Source 링크를 걸면 어떻게 될까요?
private void OnPlayClicked(object sender, EventArgs e)
{
mediaPlayer.Source = MediaSource.FromUri("http://localhost:9696");
mediaPlayer.Play();
}
물론, 저런 경우 GetFile 메서드에서 mp4 파일을 읽어 반환하면 될 텐데요,
private static async Task GetFile(IHttpContext ctx)
{
// Resources/Raw/file_example_MP4_1920_18MG.mp4
using var stream = await FileSystem.OpenAppPackageFileAsync("file_example_MP4_1920_18MG.mp4");
var responseStream = ctx.OpenResponseStream();
stream.CopyTo(responseStream);
}
하지만 그전에 MediaElement 측에서 이런 예외가 발생합니다.
[ExoPlayerImplInternal] Playback error
[ExoPlayerImplInternal] com.google.android.exoplayer2.ExoPlaybackException: Source error
[ExoPlayerImplInternal] at com.google.android.exoplayer2.ExoPlayerImplInternal.handleIoException(ExoPlayerImplInternal.java:684)
[ExoPlayerImplInternal] at com.google.android.exoplayer2.ExoPlayerImplInternal.handleMessage(ExoPlayerImplInternal.java:656)
[ExoPlayerImplInternal] at android.os.Handler.dispatchMessage(Handler.java:102)
[ExoPlayerImplInternal] at android.os.Looper.loopOnce(Looper.java:201)
[ExoPlayerImplInternal] at android.os.Looper.loop(Looper.java:288)
[ExoPlayerImplInternal] at android.os.HandlerThread.run(HandlerThread.java:67)
[ExoPlayerImplInternal] Caused by: com.google.android.exoplayer2.upstream.HttpDataSource$CleartextNotPermittedException: Cleartext HTTP traffic not permitted. See https://developer.android.com/guide/topics/media/issues/cleartext-not-permitted
...[생략]...
이에 대해서는 위의 링크에도 설명하고 있지만 마이크로소프트 측의 문서를 봐도 됩니다.
Connect to local web services from Android emulators and iOS simulators
; https://learn.microsoft.com/en-us/dotnet/maui/data-cloud/local-web-services
한 마디로, http 통신은 허용하지 않고 https만 가능하다는 것입니다. 물론, http 통신을 원한다면 약간의 설정을 더 추가하면 되는데요, 이를 위해, 우선 Platforms\Android\Resources\xml 디렉터리에 network_security_config.xml 파일명으로 다음의 내용을 포함해 둡니다.
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
<domain-config cleartextTrafficPermitted="true">
<domain includeSubdomains="true">localhost</domain>
</domain-config>
</network-security-config>
그리고, 반드시 저 파일의 "Build Action"을 "AndroidResource"로 설정해야 합니다. 그렇지 않으면 컴파일 시 "error APT2260: resource xml/network_security_config (aka com.companyname.simpleplayer:xml/network_security_config) not found." 오류가 발생합니다.
그다음 AndroidManifest.xml에 위의 파일 경로를 networkSecurityConfig 속성으로 알립니다.
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<application android:allowBackup="true"
android:networkSecurityConfig="@xml/network_security_config"
android:icon="@mipmap/appicon" android:roundIcon="@mipmap/appicon_round" android:supportsRtl="true"></application>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
</manifest>
끝입니다. 이제 다시 실행하면, Web Server는 Resources/Raw/file_example_MP4_1920_18MG.mp4 파일을 읽어 반환하고, MediaElement는 이를 받아 동영상을 화면에 출력합니다.
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]