Esquema de URI de Sway

En este documento se define el formato de identificadores uniformes de recursos (URI) para la aplicación Sway para Windows. Puede usar este esquema de URI para invocar la aplicación de Sway con varios comandos.

sintaxis del esquema uri de Sway

A continuación se muestra la sintaxis del esquema URI:

<ms-sway>:<command-argument>

• <ms-sway>: indica que Sway es la aplicación que se va a invocar. Cuando se instala Sway para Windows, ms-sway se registra con Windows para que sea el controlador de Sway.
• <command-argument> : es posible que un URI tenga uno o varios argumentos de comando, delimitados por el carácter ampersand (&). Cuando se incluye más de un argumento de comando en un URI, un carácter de y comercial (&) debe separar cada argumento de comando del siguiente argumento de comando. Los argumentos de comando varían según el escenario.

Argumentos de comando

Se pueden incluir varios argumentos de comando como parte del esquema de dirección URL de Sway. Estos argumentos de comando no son necesarios. Si no incluye los argumentos de comando, se invoca la aplicación Sway.

Nombre del argumento de comando	Descripción	Tipo	Posibles valores	¿Necesario?
id	Identificador único de un Sway. Se usa para indicar el Sway que se va a abrir.	Cadena	Identificador único válido para un Sway. El identificador siempre forma parte de la dirección URL de un Sway. Por ejemplo, para el siguiente Sway https://sway.com/dBheQgVZ1RQBfiQU, el identificador es dBheQgVZ1RQBfiQU. Si la cuenta de usuario asociada a la aplicación Sway tiene permisos de edición, la aplicación abre el Sway en modo de edición. De lo contrario, la aplicación abre el Sway en modo de vista.	No
mode	Modo en el que se debe abrir un Sway específico, ya sea para editarlo o para verlo.	Cadena	edit vista NOTA: Si no se especifica ningún identificador , se omite este argumento de comando.	No
auth_upn	Cuenta que se va a usar al abrir Sway.	Cadena	Una dirección de correo electrónico válida. Si la dirección de correo electrónico especificada no está asociada a una cuenta de Sway, Sway pide al usuario que inicie sesión como el usuario especificado. Si hay más de una cuenta asociada a la aplicación Sway y existe la dirección de correo electrónico especificada, la aplicación Sway cambia a usar esa cuenta cuando se invoca.	No
auth_pvr	Tipo de cuenta que se va a usar para abrir la Sway, ya sea una cuenta microsoft o una cuenta de Microsoft Entra ID.	Cadena	WindowsLiveId: especifica que la cuenta de auth_upn es una cuenta de Microsoft. OrgId: especifica que la cuenta de auth_upn es una cuenta de Microsoft Entra. Si no se especifica ningún auth_upn , se omite este argumento de comando.	No
invoking_app	Nombre de la aplicación de Windows que se usa para invocar Sway.	Cadena	Nombre descriptivo de la aplicación de Windows que se usa para invocar Sway a través del esquema de dirección URL de Sway. El propósito de este argumento de comando es la telemetría y el seguimiento.	No

Semántica del esquema URI

El <ms-sway> esquema define una sintaxis uri para abrir un Sway o para invocar la aplicación Sway. El esquema define varios argumentos de comando, que se pueden usar para hacer lo siguiente:

• Abra la aplicación Sway: no es necesario especificar ningún argumento de comando.

• Abra una Sway para verla en la aplicación Sway: es necesario especificar el identificador y el modo establecidos para ver.

• Abra un Sway para su edición en la aplicación Sway: es necesario especificar el identificador y el modo establecidos para editar. Se recomienda incluir también auth_upn y auth_pvr para ayudar a garantizar que se usa la cuenta correcta con permisos de edición cuando se abre Sway.

Ejemplo

ms-sway:id=CyrvEYLmFKi1B2_I&auth_upn=account@email.com&auth_pvr=WindowsLiveId&invoking_app=MyApp