Plugin.MediaManager.FFmpegMediaMetadataRetriever 1.2.2

MediaManager - 支持Xamarin和Windows的跨平台媒体插件

• 设计简洁，易于使用
• 支持从远程 http(s)、嵌入和本地源播放媒体文件
• 支持媒体通知和远程控制
• 默认提供队列和播放管理
• 播放状态 (播放、缓冲、加载、暂停、进度)
• 媒体处理事件以进行钩子

状态

支持

• 随时欢迎提出问题。请确保使用其中一个模板！
• 提供商业支持。与您的应用程序或服务集成、示例、功能请求等。电子邮件： [email protected]
• 电动车运动： baseflow.com

Wiki

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

博客

• Xamarin 博客
• Baseflow 博客

安装

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

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

平台支持

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

用法

从任何 .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 启动您的活动。在大多数情况下，您可能希望将 LaunchMode 设置为 SingleTop。这将使在点击时将应用带回焦点。有关详细信息，请参阅 此处

[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() 释放播放器。如果在使用释放之前播放其他媒体文件，请确保调用 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;

然后您可以通过这种方式手动添加视频视图

对于 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

如果您想使用FFmpegMediaMetadataRetriever从Android中提取元数据，可以使用以下方式设置为使用此扩展：

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.xml中。
• 您的应用程序必须针对Android SDK v28或更高版本
• 此库使用ExoPlayer进行视频播放。此要求您启用以下：
• Dex工具到D8：<AndroidDexTool>d8</AndroidDexTool>
• 可选启用R8链接器以使代码更小：<AndroidLinkTool>r8</AndroidLinkTool>
• Aapt2构建工具：<AndroidUseAapt2>true</AndroidUseAapt2>
• 当使用D8和R8以及AAPT2时禁用多Dex。您的代码应该足够小。

iOS

• 为了使音频在后台继续播放，您必须将“音频、Airplay和画中画后台模式”以及“后台获取”添加到您的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下的功能中，您需要选择：“后台媒体播放”、“Internet”
• 如有需要，也可以添加“音乐库”和“视频库”

Tizen

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

构建源代码

• 在Windows上，您需要安装带有最新Xamarin、.NET Core、UWP和Windows 10 SDK的Visual Studio 2019。
• 在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。