Xamarin.Essentials:手电筒
Flashlight 类,此类使你能够打开或关闭设备的照相机闪光灯,将其转换为一个手电筒。
若要开始使用此 API,请阅读 Xamarin.Essentials 的入门指南,确保在项目中正确安装和设置库。
若要访问 Flashlight 功能,需要以下特定于平台的设置。
需要具有 Flashlight 和 Camera 权限,并且必须在 Android 项目中进行配置。 可以通过以下方法添加权限:
打开 Properties 文件夹下的 AssemblyInfo.cs 文件并添加 :
[assembly: UsesPermission(Android.Manifest.Permission.Flashlight)]
[assembly: UsesPermission(Android.Manifest.Permission.Camera)]
或更新 Android 清单:
打开 Properties 文件夹下的 AndroidManifest.xml 文件,并在“manifest”节点内添加以下代码 。
<uses-permission android:name="android.permission.FLASHLIGHT" />
<uses-permission android:name="android.permission.CAMERA" />
或右键单击 Android 项目并打开项目的属性。 在“Android 清单”下找到“所需权限:”区域,然后选中“FLASHLIGHT”和“CAMERA”权限 。 这样会自动更新 AndroidManifest.xml 文件。
通过添加这些权限,Google Play 将自动筛选出设备,而无需任何特定硬件。 可以通过将以下代码添加到 Android 项目中的 AssemblyInfo.cs 文件中来绕过此操作:
[assembly: UsesFeature("android.hardware.camera", Required = false)]
[assembly: UsesFeature("android.hardware.camera.autofocus", Required = false)]
此 API 在 Android 上使用运行时权限。 请确保 Xamarin.Essentials 已完全初始化,并且在你的应用中设置了权限处理。
在 Android 项目的 MainLauncher
或任何已启动的 Activity
中,必须在 OnCreate
方法中初始化 Xamarin.Essentials:
protected override void OnCreate(Bundle savedInstanceState)
{
//...
base.OnCreate(savedInstanceState);
Xamarin.Essentials.Platform.Init(this, savedInstanceState); // add this line to your code, it may also be called: bundle
//...
}
若要处理 Android 上的运行时权限,Xamarin.Essentials 必须接收任何 OnRequestPermissionsResult
。 将以下代码添加到所有 Activity
类:
public override void OnRequestPermissionsResult(int requestCode, string[] permissions, Android.Content.PM.Permission[] grantResults)
{
Xamarin.Essentials.Platform.OnRequestPermissionsResult(requestCode, permissions, grantResults);
base.OnRequestPermissionsResult(requestCode, permissions, grantResults);
}
在类中添加对 Xamarin.Essentials 的引用:
using Xamarin.Essentials;
可以通过 TurnOnAsync
和 TurnOffAsync
方法来打开或关闭手电筒:
try
{
// Turn On
await Flashlight.TurnOnAsync();
// Turn Off
await Flashlight.TurnOffAsync();
}
catch (FeatureNotSupportedException fnsEx)
{
// Handle not supported on device exception
}
catch (PermissionException pEx)
{
// Handle permission exception
}
catch (Exception ex)
{
// Unable to turn on/off flashlight
}
Flashlight 类已根据设备的操作系统进行了优化。
在较新的 API 级别上,Torch 模式将用于打开或关闭设备的闪光灯。
创建一个相机表面纹理以打开或关闭相机单元的 FlashMode
。