Plugin.MediaManager.Reactive 1.2.2

MediaManager - 用于 Xamarin 和 Windows 的跨平台媒体插件

• 设计简单易用
• 本地播放远程 http(s)、内置和本地媒体文件
• 本地媒体通知和远程控制
• 默认提供队列和播放管理
• 播放状态（播放中、缓冲、加载中、暂停、进度）
• 用于媒体处理的挂钩事件

状态

支持

• 请放心提出问题。确保使用其中一个模板！
• 提供商业支持。电子邮件： [email protected]
• 由： baseflow.com

Wiki

更多文档和信息可在 Wiki 上找到

博客

• Xamarin 博客
• Baseflow 博客

安装

将NuGet 包添加到您要使用的所有项目中。

• 在 Visual Studio 中 - 工具 > NuGet 包管理器 > 解决方案管理包
• 选择“浏览”选项卡，搜索“MediaManager”
• 选择“Plugin.MediaManager”
• 将插件安装到您解决方案中的每个项目中

平台支持

平台	支持	版本	播放器
.Net Standard	是	2.0+	MediaManager
Xamarin.Forms	是	3.2+	MediaManager
Xamarin.Android	是	API 16+	ExoPlayer
Xamarin.iOS	是	iOS 10+	AVPlayer
Xamarin.Mac	是	3.0+	AVPlayer
Xamarin.tvOS	是	10.0+	AVPlayer
Tizen	是	4.0+	MediaPlayer
Windows 10 UWP	是	10+	MediaPlayer
Windows WPF (.NET Framework)	是	4.7.2+	MediaPlayer
Windows WPF (.NET Core)	是	3.1+	MediaPlayer

用法

从任何 .Net 库或 Xamarin 项目中调用 MediaManager.Current 以获取对 API 的访问权限。

重要：初始化插件

确保在应用程序启动时在所有原生平台上调用 Init()。

CrossMediaManager.Current.Init();

可选地提供 Android 上的 Activity。这还将用于绑定 Android Service，并用作从通知启动的 Intent。

public class MainActivity : AppCompatActivity
{
	protected override void OnCreate(Bundle savedInstanceState)
	{
		base.OnCreate(savedInstanceState);
		SetContentView(Resource.Layout.main_activity);

		CrossMediaManager.Current.Init(this);
	}
}

当点击通知时，它将使用 intent 启动您的小程序。在大多数情况下，您可能希望将您的 Activity 的 LaunchMode 设置为 SingleTop。这应该会在点击时使您的应用程序重新获得焦点。《[链接](https://developer.android.com.cn/guide/topics/manifest/activity-element.html#lmode)》您可以在此处了解更多信息。

[Activity(LaunchMode = LaunchMode.SingleTop)]
public class MainActivity : AppCompatActivity

如果您想处理通过通知点击打开应用程序的情况，您可以在活动上覆盖 OnNewIntent。

protected override void OnNewIntent(Intent intent)
{
    base.OnNewIntent(intent);
    // TODO: Handle app opened from notification tap.
}

释放

可以通过 CrossMediaManager.Current.Dispose() 释放播放器。如果在使用 dispose 之前播放了另一个媒体文件，请确保调用 CrossMediaManager.Current.Init()。

播放单个媒体项

//Audio
await CrossMediaManager.Current.Play("https://ia800806.us.archive.org/15/items/Mp3Playlist_555/AaronNeville-CrazyLove.mp3");
//Video
await CrossMediaManager.Current.Play("http://clips.vorwaerts-gmbh.de/big_buck_bunny.mp4");

播放多个媒体项

public IList<string> Mp3UrlList => new[]{
	"https://ia800806.us.archive.org/15/items/Mp3Playlist_555/AaronNeville-CrazyLove.mp3",
	"https://ia800605.us.archive.org/32/items/Mp3Playlist_555/CelineDion-IfICould.mp3",
	"https://ia800605.us.archive.org/32/items/Mp3Playlist_555/Daughtry-Homeacoustic.mp3",
	"https://storage.googleapis.com/uamp/The_Kyoto_Connection_-_Wake_Up/01_-_Intro_-_The_Way_Of_Waking_Up_feat_Alan_Watts.mp3",
	"https://aphid.fireside.fm/d/1437767933/02d84890-e58d-43eb-ab4c-26bcc8524289/d9b38b7f-5ede-4ca7-a5d6-a18d5605aba1.mp3"
	};

await CrossMediaManager.Current.Play(Mp3UrlList);

其他播放可能

Task<IMediaItem> Play(IMediaItem mediaItem);
Task<IMediaItem> Play(string uri);
Task<IMediaItem> Play(IEnumerable<IMediaItem> items);
Task<IMediaItem> Play(IEnumerable<string> items);
Task<IMediaItem> Play(FileInfo file);
Task<IMediaItem> Play(DirectoryInfo directoryInfo);
Task<IMediaItem> PlayFromAssembly(string resourceName, Assembly assembly = null);
Task<IMediaItem> PlayFromResource(string resourceName);

• 例如，可以通过使用 File 和 Directory api 来从 File 进行播放。您可以通过这些 .NET api 从互联网下载文件并将其保存在某处。
• 当从 Assembly 播放时，您需要将媒体文件添加到 assembly 中，并设置构建操作为 Embedded resource。
• 当从 Resource 播放时，您应该将媒体文件添加到 Android 的 Assets 或 raw 文件夹或 iOS 的 Resources 文件夹中。

例如

await CrossMediaManager.Current.PlayFromAssembly("somefile.mp3", typeof(BaseViewModel).Assembly);
await CrossMediaManager.Current.PlayFromResource("assets:///somefile.mp3");
await CrossMediaManager.Android.PlayFromResource(Resource.Raw.somefile.ToString());

控制播放器

await CrossMediaManager.Current.Play();
await CrossMediaManager.Current.Pause();
await CrossMediaManager.Current.PlayPause();
await CrossMediaManager.Current.Stop();

await CrossMediaManager.Current.StepForward();
await CrossMediaManager.Current.StepBackward();

await CrossMediaManager.Current.SeekToStart();
await CrossMediaManager.Current.SeekTo(TimeSpan position);

控制队列

await CrossMediaManager.Current.PlayPrevious();
await CrossMediaManager.Current.PlayNext();
await CrossMediaManager.Current.PlayPreviousOrSeekToStart();
await CrossMediaManager.Current.PlayQueueItem(IMediaItem mediaItem);
await CrossMediaManager.Current.PlayQueueItem(int index);

扩展

void ToggleRepeat();
void ToggleShuffle();

检索和设置信息

IDictionary<string, string> RequestHeaders { get; set; }
TimeSpan StepSizeForward { get; set; }
TimeSpan StepSizeBackward { get; set; }
MediaPlayerState State { get; }
TimeSpan Position { get; }
TimeSpan Duration { get; }
TimeSpan Buffered { get; }
float Speed { get; set; }
RepeatMode RepeatMode { get; set; }
ShuffleMode ShuffleMode { get; set; }
bool ClearQueueOnPlay { get; set; }
bool AutoPlay { get; set; }
bool KeepScreenOn { get; set; }

扩展

bool IsPlaying();
bool IsBuffering();
bool IsPrepared();
bool IsStopped();

CrossMediaManager.Current.MediaPlayer.* 上可用的属性

IVideoView VideoView { get; set; }
bool AutoAttachVideoView { get; set; }
VideoAspectMode VideoAspect { get; set; }
bool ShowPlaybackControls { get; set; }
int VideoHeight { get; }
int VideoWidth { get; }

钩入事件

event StateChangedEventHandler StateChanged;
event BufferedChangedEventHandler BufferedChanged;
event PositionChangedEventHandler PositionChanged;
event MediaItemFinishedEventHandler MediaItemFinished;
event MediaItemChangedEventHandler MediaItemChanged;
event MediaItemFailedEventHandler MediaItemFailed;

检索媒体元数据

根据平台，媒体项的元数据将从文件的 ID3 数据中提取。

CrossMediaManager.Current.Queue.Current.Title;
CrossMediaManager.Current.Queue.Current.AlbumArt;
CrossMediaManager.Current.Queue.Current.*

由于元数据可能不会立即可用，您可以订阅如下更新

var mediaItem = await CrossMediaManager.Current.Play("https://ia800806.us.archive.org/15/items/Mp3Playlist_555/AaronNeville-CrazyLove.mp3");
mediaItem.MetadataUpdated += (sender, args) => {
	var title = args.MediaItem.Title;
};

或者您也可以使用 PropertyChanged 事件来查看元数据的更新。

您还可以从视频中获取单帧

string url = "https://something.com/something.mov";
var mediaItem = await CrossMediaManager.Current.Extractor.CreateMediaItem(url);
var image = await CrossMediaManager.Current.Extractor.GetVideoFrame(mediaItem, TimeSpan.FromSeconds(1));
ImageSource imageSource = image.ToImageSource();
FormsImage.Source = imageSource;

将视频播放器添加到 UI 中

视频视图将自动附加到播放器。如果您有多个视频视图并且想要自己连接它，请执行以下操作

CrossMediaManager.Current.MediaPlayer.AutoAttachVideoView = false;

之后，您可以手动添加视频视图，例如这样

对于 Android，我们需要在 axml 布局中一个 VideoView。

<mediamanager.platforms.android.video.VideoView
	android:id="@+id/your_videoview"
	android:layout_width="match_parent"
	android:layout_height="300dp" />

然后在代码中查找视图

playerView = view.FindViewById<VideoView>(Resource.Id.your_videoview);

对于 iOS、MacOS 或 tvOS，我们需要在代码中、Xib 或 Storyboard 中添加一个 VideoView。

var playerView = new VideoView();
View.AddSubview(playerView);

然后对于所有平台，我们必须将播放器视图添加到 MediaPlayer

CrossMediaManager.Current.MediaPlayer.VideoView = playerView;

播放非标准格式，如 HLS、Dash 或 SS

MediaManager 将尝试猜测所使用的媒体类型或格式。有时这不会检测到或检测错误，但您可以自己设置它，如下所示

var item = await CrossMediaManager.Current.Extractor.CreateMediaItem("https://devstreaming-cdn.apple.com/videos/streaming/examples/bipbop_16x9/bipbop_16x9_variant.m3u8");
item.MediaType = MediaType.Hls;

await CrossMediaManager.Current.Play(item);

通过强制执行，仍然没有办法保证原生系统实际上能够播放该项目。

平台特定功能

功能	Android	iOS, Mac, tvOS	UWP	Tizen	WPF
音频	✓	✓	✓	✓	✓
视频	✓	✓	✓	✓	✓
队列	✓	✓	✓	✓	✓
通知	✓	✓	✓	✓	✓
音量	✓	✓	✓	✓	✓
媒体提取	✓	✓	✓	✓	✓
HLS	✓	✓
DASH	✓
SmoothStreaming	✓
ChromeCast	✓
Airplay		✓
Xamarin.Forms	✓	✓	✓		✓

如果你需要的话，也可以直接访问原生平台的实现！

//Android
CrossMediaManager.Android.*
//iOS, MacOS or tvOS
CrossMediaManager.Apple.*
//UWP
CrossMediaManager.Windows.*
//Tizen
CrossMediaManager.Tizen.*
//WPF
CrossMediaManager.Wpf.*

Xamarin.Forms

在表单中添加 VideoView 就像这样很简单

<mm:VideoView VerticalOptions="FillAndExpand" Source="http://clips.vorwaerts-gmbh.de/big_buck_bunny.mp4" />

你的 Xamarin.Forms 页面可以看起来像这样

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage
    xmlns="http://xamarin.com/schemas/2014/forms"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:mm="clr-namespace:MediaManager.Forms;assembly=MediaManager.Forms"
    x:Class="YourClassName" >
    <ContentPage.Content>
        <StackLayout>
            <mm:VideoView VerticalOptions="FillAndExpand" Source="http://clips.vorwaerts-gmbh.de/big_buck_bunny.mp4" ShowControls="False" />
        </StackLayout>
    </ContentPage.Content>
</ContentPage>

你甚至可以使用常规的 Play(object) 方法而不设置源。当你导航到含有 VideoView 的视图时，播放器会自动附加到该视图。

如果你想要一个包含播放器的页面，可以打开 VideoPage。

Navigation.PushAsync(new MediaManager.Forms.VideoPage());

响应式扩展

将 响应式 NuGet 包 添加到你想使用它的所有项目中。

用法

CrossMediaManager.Current.Reactive().*

Android 上的 FFmpegMediaMetadataRetriever

如果你想在 Android 上使用 FFmpegMediaMetadataRetriever 提取元数据，可以通过这种方式设置来使用此扩展

CrossMediaManager.Android.Extractor = new FFmpegMediaExtractor();

拦截来自原生平台或其他应用程序的分享请求

Android

//Add code to the OnCreate(Bundle savedInstanceState) of your MainActivity
if(await CrossMediaManager.Android.PlayFromIntent(Intent))
{
    //If true maybe do an action like opening a Player Page.
}

重要

Android

• 此库将自动请求以下权限：AccessWifiState、AccessNetworkState、Internet、ForegroundService 和 WakeLock。你不需要将它们添加到你的 AndroidManifest 中。
• 你的应用程序必须针对 Android SDK v28 或更高版本
• 此库使用 ExoPlayer 进行视频播放。这要求你启用以下
• Dex 工具到 D8: <AndroidDexTool>d8</AndroidDexTool>
• 可选启用 R8 Linker 以缩小代码大小: <AndroidLinkTool>r8</AndroidLinkTool>
• Aapt2 构建工具: <AndroidUseAapt2>true</AndroidUseAapt2>
• 当使用与 AAPT2 一起的 D8 和 R8 时禁用多 Dex。你的代码应该足够小。

iOS

• 为了使音频在后台继续播放，你必须将 'Audio, Airplay and Picture in Picture Background mode' 和 'Background fetch' 添加到你的 Info.plist 中

<key>UIBackgroundModes</key>
<array>
	<string>audio</string>
	<string>fetch</string>
</array>

• 如果你正在播放来自 http 资源的音频，你必须处理 ATS。可选地，你可以禁用媒体播放时的此功能。将以下添加到你的 Info.plist 中

<key>NSAppTransportSecurity</key>
<dict>
	<key>NSAllowsArbitraryLoadsInMedia</key>
	<true/>
</dict>

如果你想禁用更多，可以添加：NSAllowsLocalNetworking 或甚至 NSAllowsArbitraryLoads 以禁用所有检查。

• 如果你想在 MP3 文件中显示嵌入的艺术作品/封面，确保你使用 ID3 v2.3 (不是 v2.4)。

UWP

• 在 Package.appxmanifest 下的功能中，你需要选择："Background Media Playback"、"Internet"。
• 如果使用，可选添加 "Music Library" 和 "Videos Library"。

Tizen

• 你必须请求 http://tizen.org/privilege/internet、http://tizen.org/privilege/mediastorage 和 http://tizen.org/privilege/externalstorage 权限

构建源代码

• 在 Windows 上，你需要安装最新的 Visual Studio 2019、Xamarin、.NET Core、UWP 和 Windows 10 SDK。
• 在 Visual Studio for Mac 2019 中不支持多目标。因此，你需要在 Mac 上通过命令行进行编译。简单地说，转到代码源码所在的文件夹，运行以下命令来创建发布版：msbuild MediaManager.sln /t:rebuild 要运行发布版，请使用：msbuild MediaManager.sln /t:rebuild /p:Configuration=Release。要恢复 NuGet 包，请运行：msbuild MediaManager.sln /t:restore。