Uso compartido y recepción de contenido (HTML)

[ Este artículo está destinado a desarrolladores de Windows 8.x y Windows Phone 8.x que escriben aplicaciones de Windows en tiempo de ejecución. Si estás desarrollando para Windows 10, consulta la documentación más reciente

A menudo, los usuarios encuentran información que los entusiasma y que quieren compartir con alguien o usar en otra aplicación. Los recursos compartidos son una característica ligera y en contexto que puedes añadir de forma sencilla a tu aplicación.

Una aplicación puede admitir la característica Compartir de dos modos. En primer lugar, puede tratarse de una aplicación de origen que proporciona contenido que el usuario desea compartir. En segundo lugar, puede tratarse de una aplicación de destino que el usuario selecciona como el destino del contenido compartido. Una aplicación puede ser de origen y de destino. Si quieres que tu aplicación comparta contenido como aplicación de origen, debes decidir qué formatos de datos puede proporcionar. Te recomendamos que intentes admitir tantos tipos de formato como sea posible, pero en última instancia debes elegir los tipos que funcionan mejor con tu aplicación. Después de tomar esa decisión, usa las clases del espacio de nombres Windows.ApplicationModel.DataTransfer para empaquetar los datos.

Si quieres que tu aplicación reciba contenido compartido como aplicación de destino, primero debes configurar el archivo de manifiesto de tu aplicación para indicar que admite el contrato para contenido compartido.

Nota  

Los usuarios de la aplicación pueden compartir contenido de tu aplicación con un simple gesto de deslizar rápidamente desde el acceso a Compartir. Un usuario puede compartir un archivo o una URL desde tu aplicación con otro dispositivo utilizando Tocar y enviar en el acceso Dispositivos.

Nota  

La barra Accesos no existe en Windows Phone 8.1, de modo que el programador debe incluir las opciones de uso compartido mediante programación como parte de la barra o de otro control de una aplicación.

Este contrato para contenido compartido permite que se presente la aplicación como una opción, cuando el usuario invoca el uso compartido en escenarios en los que se comparten los formatos de datos admitidos. A la hora de elegir los formatos de datos que admitirá tu aplicación de destino, solo debes registrar aquellos con los que tu aplicación pueda trabajar. Para obtener más información, consulta Elección de formatos de datos. Cuando el usuario invoca la opción Compartir, solo aparecen las aplicaciones de destino que admiten los datos que se van a compartir.

Si usas Visual Studio, para agregar a tu aplicación el contrato para contenido compartido, elige Agregar nuevo elemento en el menú Proyecto y luego selecciona Contrato para aceptar contenido compartido en la lista. Como parte de este proceso, debes especificar la lista de formatos de datos y tipos de archivos que puede aceptar tu aplicación. Los formatos se especifican en la pestaña Declaraciones mientras se edita el archivo package.appxmanifest en Visual Studio.

Para obtener más información sobre la compatibilidad con el contrato para contenido compartido en el archivo del manifiesto de la aplicación, consulta Inicio rápido: Recepción de contenido compartido y ShareTarget en la referencia del esquema de manifiesto del paquete.

Para ver un ejemplo de cómo compartir contenido, consulta los temas de muestra de una aplicación de origen de contenido compartido y muestra de una aplicación de destino de contenido compartido o lee los temas de Inicio rápido: compartir contenido e Inicio rápido: recepción de contenido compartido.

El siguiente diagrama muestra una vista de alto nivel sobre cómo funciona el uso compartido.

Nota  

Los vínculos rápidos no son compatibles con Windows Phone 8.1. Si una aplicación de destino devuelve un vínculo rápido, la aplicación de origen lo omitirá automáticamente.

Puedes especificar el formulario que se abre cuando se active la aplicación mediante el contrato para contenido compartido. De esa manera, puedes crear una experiencia personalizada específicamente para el uso compartido de contenido. Puedes encontrar más información acerca de esta y otras consideraciones de diseño en el tema sobre Directrices y lista de comprobación de uso compartido de contenido.

Nota  

Si estás implementando una aplicación de destino, ten en cuenta la experiencia de la interfaz de usuario. En Windows, cuando el usuario selecciona tu aplicación, esta se mostrará usando el control flotante Compartir. Este estado de visualización es uno de los distintos modos en que se puede mostrar una aplicación en la pantalla. Asegúrate de que la interfaz de la aplicación tiene un aspecto limpio y organizado para compartir contenido en el control flotante Compartir.

No se puede modificar el contenido que recibe tu aplicación de una aplicación de origen. Sin embargo, puedes informar al sistema de que tu aplicación ha recibido los datos e indicar el momento en que se procesaron. Esto es importante, especialmente en el caso de contenido como las imágenes, cuya carga y procesamiento puede tardar cierto tiempo. Nuestra Muestra de una aplicación de destino de contenido compartido muestra cómo funciona esto. También puedes consultar Inicio rápido: recepción de contenido compartido para obtener información detallada.

No olvides que aunque estos roles (origen y destino) son distintos, puedes admitir ambos en una misma aplicación. Por ejemplo, es posible que una aplicación de uso compartido de fotos quiera actuar como aplicación de origen para que los usuarios puedan enviar fotos por correo electrónico a otros y, además, actuar como aplicación de destino para que los usuarios puedan cargar álbumes de fotos con imágenes nuevas.

Consulta los siguientes temas y muestras de aplicaciones para comenzar a agregar la función de uso compartido en tu aplicación:

• Directrices y lista de comprobación de uso compartido de contenido. Ya sea que estés escribiendo una aplicación de origen o de destino, este tema proporciona información útil que puede ayudarte a proporcionar la mejor experiencia del usuario posible para compartir contenido.
• Elección de formatos de datos para uso compartido Conoce los formatos estándar para compartir y el procedimiento para crear y usar formatos personalizados cuando no se aplican los formatos estándar.
• Uso compartido de contenido. Aquí aprenderás los conceptos básicos acerca de cómo implementar una aplicación de origen. También analizamos escenarios más específicos y proporcionamos algunos detalles que debes tener en cuenta durante la implementación.
• Recepción de contenido compartido. Estos temas describen el modo en que se agrega el contrato para contenido compartido a tu aplicación, los conceptos básicos de cómo detectar si un usuario selecciona tu aplicación para compartir contenido y cómo procesar los datos que se comparten. También describimos algunos escenarios específicos para ayudarte a comenzar con rapidez.
• Muestra de una aplicación de origen de contenido compartido Esta muestra indica cómo iniciar una operación de compartir y el contenido de paquete para compartir.
• Muestra de una aplicación de destino de contenido compartido Esta muestra indica el procedimiento para recibir contenido compartido de otra aplicación.
• Directrices para depurar aplicaciones de destino Aprende sobre los problemas relacionados con la depuración de una aplicación de destino de contenido compartido.