PhotoKit en Xamarin.iOS

Descarga de un ejemplo de código

PhotoKit es un marco que permite a las aplicaciones consultar la biblioteca de imágenes del sistema y crear interfaces de usuario personalizadas para ver y modificar su contenido. Incluye una serie de clases que representan recursos de imagen y vídeo, así como colecciones de recursos como discos y carpetas.

Permisos

Para que la aplicación pueda acceder a la biblioteca de fotos, se mostrará al usuario un cuadro de diálogo de permisos. Debe proporcionar texto explicativo en el archivo Info.plist para explicar cómo usa la aplicación la biblioteca de fotos, por ejemplo:

<key>NSPhotoLibraryUsageDescription</key>
<string>Applies filters to photos and updates the original image</string>

Objetos de modelo

PhotoKit representa estos recursos en lo que llama objetos de modelo. Los objetos de modelo que representan las fotos y los vídeos son de tipo PHAsset . contiene metadatos como el tipo de medio del recurso PHAsset y su fecha de creación. De forma similar, las PHAssetCollection clases y contienen PHCollectionList metadatos sobre colecciones de recursos y listas de recopilación, respectivamente. Las colecciones de recursos son grupos de recursos, como todas las fotos y vídeos de un año determinado. Del mismo modo, las listas de recopilación son grupos de colecciones de recursos, como fotos y vídeos agrupados por año.

Consulta de datos del modelo

PhotoKit facilita la consulta de datos del modelo a través de una variedad de métodos de captura. Por ejemplo, para recuperar todas las imágenes, llamaría a PHAsset.Fetch , pasando el tipo de PHAssetMediaType.Image medio.

PHFetchResult fetchResults = PHAsset.FetchAssets (PHAssetMediaType.Image, null);

A PHFetchResult continuación, la instancia de contendrá todas PHAsset las instancias que representan imágenes. Para obtener las propias imágenes, use (o la versión de almacenamiento en caché, ) para realizar una solicitud de la imagen PHImageManager mediante una llamada a PHCachingImageManagerRequestImageForAsset . Por ejemplo, el código siguiente recupera una imagen para cada recurso de para PHFetchResult mostrar en una celda de vista de colección:

public override UICollectionViewCell GetCell (UICollectionView collectionView, NSIndexPath indexPath)
{
    var imageCell = (ImageCell)collectionView.DequeueReusableCell (cellId, indexPath);
    imageMgr.RequestImageForAsset (
        (PHAsset)fetchResults [(uint)indexPath.Item],
        thumbnailSize,
        PHImageContentMode.AspectFill, new PHImageRequestOptions (),
        (img, info) => {
            imageCell.ImageView.Image = img;
        }
    );
    return imageCell;
}

Esto da como resultado una cuadrícula de imágenes como se muestra a continuación:

Guardar cambios en la fototeca

Así es cómo controlar la consulta y la lectura de datos. También puede volver a escribir los cambios en la biblioteca. Dado que varias aplicaciones interesadas pueden interactuar con la biblioteca de fotos del sistema, puede registrar un observador para recibir una notificación de los cambios mediante PhotoLibraryObserver . A continuación, cuando se realicen cambios, la aplicación puede actualizarse en consecuencia. Por ejemplo, esta es una implementación sencilla para volver a cargar la vista de colección anterior:

class PhotoLibraryObserver : PHPhotoLibraryChangeObserver
{
    readonly PhotosViewController controller;
    public PhotoLibraryObserver (PhotosViewController controller)

    {
        this.controller = controller;
    }

    public override void PhotoLibraryDidChange (PHChange changeInstance)
    {
        DispatchQueue.MainQueue.DispatchAsync (() => {
            var changes = changeInstance.GetFetchResultChangeDetails (controller.fetchResults);
            controller.fetchResults = changes.FetchResultAfterChanges;
            controller.CollectionView.ReloadData ();
        });
    }
}

Para volver a escribir los cambios desde la aplicación, cree una solicitud de cambio. Cada una de las clases de modelo tiene una clase de solicitud de cambio asociada. Por ejemplo, para cambiar PHAsset un , se crea un PHAssetChangeRequest . Los pasos para realizar cambios que se escriben en la biblioteca de fotos y se envían a observadores como el anterior son:

1. Realice la operación de edición.
2. Guarde los datos de imagen filtrados en una PHContentEditingOutput instancia de .
3. Realice una solicitud de cambio para publicar los cambios de la salida de edición.

Este es un ejemplo que reescribe un cambio en una imagen que aplica un filtro noir de imagen principal:

void ApplyNoirFilter (object sender, EventArgs e)
{
    Asset.RequestContentEditingInput (new PHContentEditingInputRequestOptions (), (input, options) => {

        // perform the editing operation, which applies a noir filter in this case
        var image = CIImage.FromUrl (input.FullSizeImageUrl);
        image = image.CreateWithOrientation((CIImageOrientation)input.FullSizeImageOrientation);
        var noir = new CIPhotoEffectNoir {
            Image = image
        };
        var ciContext = CIContext.FromOptions (null);
        var output = noir.OutputImage;
        var uiImage = UIImage.FromImage (ciContext.CreateCGImage (output, output.Extent));
        imageView.Image = uiImage;
        //
        // save the filtered image data to a PHContentEditingOutput instance
        var editingOutput = new PHContentEditingOutput(input);
        var adjustmentData = new PHAdjustmentData();
        var data = uiImage.AsJPEG();
        NSError error;
        data.Save(editingOutput.RenderedContentUrl, false, out error);
        editingOutput.AdjustmentData = adjustmentData;
        //
        // make a change request to publish the changes form the editing output
        PHPhotoLibrary.GetSharedPhotoLibrary.PerformChanges (() => {
            PHAssetChangeRequest request = PHAssetChangeRequest.ChangeRequest(Asset);
            request.ContentEditingOutput = editingOutput;
        },
        (ok, err) => Console.WriteLine ("photo updated successfully: {0}", ok));
    });
}

Cuando el usuario selecciona el botón, se aplica el filtro:

Y gracias a PHPhotoLibraryChangeObserver , el cambio se refleja en la vista de colección cuando el usuario vuelve a navegar: