[ImageCaptureCore] Add managed handlers for request methods (#17376)

Add overloads for request methods to provide a cleaner implementation.
Rather than passing a delegate, selector, and context info as separate
arguments, users can now use these methods with just a single delegate
parameter.

No manual tests were added due to methods requiring a physical device,
but created a [sample camera browser
app](https://github.com/xamarin/mac-samples/pull/146) to test
functionality of updated methods.

Fixes #5093

---------

Co-authored-by: GitHub Actions Autoformatter <github-actions-autoformatter@xamarin.com>

src/ImageCaptureCore/ICCameraDevice.cs

@@ -0,0 +1,85 @@
+using System;
+using Foundation;
+using ObjCRuntime;
+#nullable enable
+
+namespace ImageCaptureCore {
+	partial class ICCameraDevice {
+
+		public delegate void DidReadDataDelegate (NSData? data, ICCameraFile? file, NSError? error);
+
+		public void RequestReadDataFromFile (ICCameraFile file, long offset, long length, DidReadDataDelegate callback)
+		{
+			var actionObject = new DidReadDataFromFileAction (callback);
+			RequestReadDataFromFile (file, offset, length, actionObject, new Selector (DidReadDataFromFileAction.CallbackSelector), IntPtr.Zero);
+		}
+
+		class DidReadDataFromFileAction : NSObject {
+			DidReadDataDelegate Callback;
+			public const string CallbackSelector = "didReadData:fromFile:error:contextInfo:";
+
+			public DidReadDataFromFileAction (DidReadDataDelegate callback)
+			{
+				Callback = callback;
+				IsDirectBinding = false;
+			}
+
+			[Export (CallbackSelector)]
+			void DidReadDataDelegate (NSData data, ICCameraFile file, NSError error, IntPtr contextInfo)
+			{
+				Callback (data, file, error);
+			}
+		}
+
+		public delegate void DidDownloadDataDelegate (ICCameraFile? file, NSError? error, NSDictionary<NSString, NSObject>? options);
+
+		public void RequestDownloadFile (ICCameraFile file, NSDictionary<NSString, NSObject> options, DidDownloadDataDelegate callback)
+		{
+			var actionObject = new DidDownloadDataFromFileAction (callback);
+			RequestDownloadFile (file, options, actionObject, new Selector (DidDownloadDataFromFileAction.CallbackSelector), IntPtr.Zero);
+		}
+
+		class DidDownloadDataFromFileAction : ICCameraDeviceDownloadDelegate {
+			DidDownloadDataDelegate Callback;
+			public const string CallbackSelector = "didDownloadFile:error:options:contextInfo:";
+
+			public DidDownloadDataFromFileAction (DidDownloadDataDelegate callback)
+			{
+				Callback = callback;
+				IsDirectBinding = false;
+			}
+
+			[Export (CallbackSelector)]
+			void DidDownloadDataDelegate (ICCameraFile file, NSError error, NSDictionary<NSString, NSObject> options, IntPtr contextInfo)
+			{
+				Callback (file, error, options);
+			}
+		}
+
+		public delegate void DidSendPtpDelegate (NSData? command, NSData? data, NSData? response, NSError? error);
+
+		public void RequestSendPtpCommand (NSData command, NSData data, DidSendPtpDelegate callback)
+		{
+			var actionObject = new DidSendPtpAction (callback);
+			RequestSendPtpCommand (command, data, actionObject, new Selector (DidSendPtpAction.CallbackSelector), IntPtr.Zero);
+		}
+
+		class DidSendPtpAction : NSObject {
+			DidSendPtpDelegate Callback;
+			public const string CallbackSelector = "didSendPTPCommand:inData:response:error:contextInfo:";
+
+			public DidSendPtpAction (DidSendPtpDelegate callback)
+			{
+				Callback = callback;
+				IsDirectBinding = false;
+			}
+
+			[Export (CallbackSelector)]
+			void DidSendPtpDelegate (NSData command, NSData data, NSData response, NSError error, IntPtr contextInfo)
+			{
+				Callback (command, data, response, error);
+			}
+		}
+	}
+
+}

src/frameworks.sources

@@ -984,7 +984,10 @@ IAD_SOURCES = \
 
 # ImageCaptureKit
 IMAGECAPTURECORE_API_SOURCES = \
-	ImageCaptureCore/Defs.cs
+	ImageCaptureCore/Defs.cs \
+
+IMAGECAPTURECORE_SOURCES = \
+	ImageCaptureCore/ICCameraDevice.cs \
 
 # ImageIO