Plugin.MediaManager.AzureMediaServices 1.2.2

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

• 设计简单，易于使用
• 从远程 http(s)、嵌入式和本地源进行原生媒体文件播放
• 原生媒体通知和远程控制
• 默认的队列和播放管理
• 播放状态（播放、缓冲、加载、暂停、进度）
• 用于媒体处理的挂钩事件

状态

支持

• 欢迎提交问题。请确保使用模板之一！
• 提供商业支持。与您的应用程序或服务集成，示例，功能请求等。邮箱： [email protected]
• 由： baseflow.com 提供支持

Wiki

更详细的信息和文档可在 Wiki 上找到

博客

• Xamarin 博客
• Baseflow 博客

安装

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

• 在 Visual Studio 中 - 工具 > NuGet 包管理器 > 管理解决方案包
• 选择“浏览”选项卡，搜索 MediaManager
• 选择插件：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);
	}
}

当点击通知时，它将带有意图启动您的活动。在大多数情况下，您可能希望在 Activity 上设置 LaunchMode 为 SingleTop。这将使在点击时重新聚焦您的应用程序。《[在此处阅读更多](https://android-docs.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 播放时，需要将媒体文件添加到程序集并设置生成操作为 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;

然后，您可以手动添加视频视图，如下所示

对于安卓，我们需要的 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，我们需要在代码中添加一个 VideoView 或者在 Xib 或 Storyboard 中。

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	✓	✓	✓		✓

如果需要，您也可以直接访问 native 平台实现！

//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());

反应性扩展

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

用法

CrossMediaManager.Current.Reactive().*

Android 上的 FFmpegMediaMetadataRetriever

如果您想使用 FFmpegMediaMetadataRetriever 在 Android 上提取元数据，可以像这样设置使用此扩展：

CrossMediaManager.Android.Extractor = new FFmpegMediaExtractor();

截获来自 native 平台或其他应用的消息请求

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>
• 在使用 D8 和 R8 与 AAPT2 时禁用多套接字。使用这些工具时，您的代码应该足够小。

iOS

• 为了使音频在后台继续播放，您需要在您的 Info.plist 中添加 'Audio, Airplay and Picture in Picture Background mode' 和 'Background fetch'。

<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。