Cómo crear un vínculo rápido (HTML)

Artículo
12/12/2015

[ 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

Lo usuarios quieren que la capacidad de compartir contenido con amigos y familiares sea una extensión de su experiencia con el equipo. Las aplicaciones que adoptan este concepto crean un entorno que permite a los usuarios compartir contenido rápida y fácilmente. Con el Contrato para aceptar contenido compartido, puedes hacer que la experiencia de compartir sea aún más sencilla gracias a un acceso directo personalizado llamado QuickLink. Un QuickLink actúa como un vínculo a tu aplicación que está personalizado para un conjunto específico de acciones de usuario.

Cuando los usuarios comparten contenido, normalmente quieren elegir cómo compartirlo y con quién. Un ejemplo habitual de esto es compartir por correo electrónico. Si un usuario quiere compartir algo por correo electrónico, tiene que proporcionar las direcciones de correo electrónico de las personas con quienes desea compartir el contenido. Aunque al usuario no le importe tener que especificar estas direcciones de correo electrónico la primera vez, agregarlas manualmente de nuevo en posteriores sesiones resulta tedioso. Una mejor experiencia es que la aplicación de correo electrónico cree un QuickLink para que la próxima vez se apliquen las opciones seleccionadas por el usuario la vez anterior.

Un QuickLink en realidad no almacena datos. En su lugar, contiene un identificador que, cuando se selecciona, se envía a tu aplicación. Para que los vínculos rápidos funcionen, tu aplicación debe almacenar los datos en alguna ubicación (por ejemplo, en la nube o en el equipo del usuario) junto con el identificador asociado. Puedes hacer esto de muchas maneras. Para conocer una manera de almacenar datos, consulta el tema sobre la administración de datos de la aplicación.

Para obtener más información acerca de cómo integrar la aplicación en el Contrato para aceptar contenido compartido, consulta Inicio rápido: recepción de contenido compartido. Este tema describe los pasos básicos que debe seguir tu aplicación cuando los usuarios la seleccionan para compartir contenido.

Lo que debes saber

Tecnologías

Requisitos previos

Debes estar familiarizado con Microsoft Visual Studio y sus plantillas asociadas.
Debes estar familiarizado con JavaScript.
Debes saber cómo recibir contenido, según se describe en Inicio rápido: recepción de contenido compartido.

Instrucciones

Paso 1: Crear un objeto QuickLink.

El objeto QuickLink forma parte de la clase ShareOperation.

var quickLink = new Windows.ApplicationModel.DataTransfer.ShareTarget.QuickLink();

Paso 2: Agregar un identificador al QuickLink.

Una vez que tengas una instancia del objeto QuickLink, debes configurarlo con un identificador de destino que el sistema pueda devolver a tu aplicación cuando el usuario seleccione el QuickLink. El siguiente ejemplo muestra cómo configurar un identificador de destino.

quickLink.id = "123456789";

Paso 3: Agregar un título al QuickLink.

Después, especifica un título para el QuickLink. El título ayuda al usuario a identificar el QuickLink y su propósito.

quickLink.title = document.getElementById("quickLinkTitle").value;

// For quicklinks, the supported FileTypes and DataFormats are set 
// independently from the manifest.
var dataFormats = Windows.ApplicationModel.DataTransfer.StandardDataFormats;
quickLink.supportedFileTypes.replaceAll(["*"]);
quickLink.supportedDataFormats.replaceAll([dataFormats.text, dataFormats.uri, 
    dataFormats.bitmap, dataFormats.storageItems, dataFormats.html, customFormatName]);

Windows.ApplicationModel.Package.current.installedLocation.getFileAsync("images\\user.png").then(function (iconFile) {
    quickLink.thumbnail = Windows.Storage.Streams.RandomAccessStreamReference.createFromFile(iconFile);
});

Paso 4: Especificar los tipos de archivo admitidos

A continuación, debes especificar los tipos de archivo y formatos de datos que admite el QuickLink. El sistema muestra el QuickLink solo cuando el DataPackage compartido desde la aplicación de origen de uso compartido contiene uno de estos tipos de archivo o formatos de datos.

var dataFormats = Windows.ApplicationModel.DataTransfer.StandardDataFormats;
quickLink.supportedFileTypes.replaceAll(["*"]);
quickLink.supportedDataFormats.replaceAll([dataFormats.text, dataFormats.uri, 
    dataFormats.bitmap, dataFormats.storageItems, dataFormats.html, customFormatName]);

Paso 5: Agregar una miniatura al QuickLink.

Te recomendamos que uses el mismo icono que verían los usuarios si seleccionaran tu aplicación sin un QuickLink. De ese modo, el usuario sabrá que el vínculo está asociado con tu aplicación.

Windows.ApplicationModel.Package.current.installedLocation.getFileAsync("images\\user.png").then(function (iconFile) {
    quickLink.thumbnail = Windows.Storage.Streams.RandomAccessStreamReference.createFromFile(iconFile);
});

Paso 6: Envía el QuickLink al sistema.

Cuando hayas terminado de crear el QuickLink, puedes enviarlo al sistema llamando al método ShareOperation.reportCompleted.

shareOperation.reportCompleted(quickLink);

Ejemplo completo

La siguiente función crea y devuelve un QuickLink. Llama a esta función después de que tu aplicación termine la operación de uso compartido de contenido, en lugar de llamar a ShareOperation.reportCompleted directamente.

function reportCompleted() {
    var quickLink = new Windows.ApplicationModel.DataTransfer.ShareTarget.QuickLink();
    quickLink.id = "123456789";
    quickLink.title = document.getElementById("quickLinkTitle").value;
    
    // For quicklinks, the supported FileTypes and DataFormats are set 
    // independently from the manifest.
    var dataFormats = Windows.ApplicationModel.DataTransfer.StandardDataFormats;
    quickLink.supportedFileTypes.replaceAll(["*"]);
    quickLink.supportedDataFormats.replaceAll([dataFormats.text, dataFormats.uri, 
        dataFormats.bitmap, dataFormats.storageItems, dataFormats.html, customFormatName]);

    Windows.ApplicationModel.Package.current.installedLocation.getFileAsync("images\\user.png").then(function (iconFile) {
        quickLink.thumbnail = Windows.Storage.Streams.RandomAccessStreamReference.createFromFile(iconFile);
        shareOperation.reportCompleted(quickLink);
    });
}