Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
В этом документе определяется формат универсальных идентификаторов ресурсов (URI) для приложения Sway для Windows. Эту схему URI можно использовать для вызова приложения Sway с помощью различных команд.
синтаксис схемы URI Sway
Ниже приведен синтаксис схемы URI:
<ms-sway>:<command-argument>
-
<ms-sway>— указывает, что Sway является приложением для вызова. При установкеms-swaySway для Windows регистрируется в Windows как обработчик Sway. -
<command-argument>— Универсальный код ресурса (URI) может содержать один или несколько аргументов команды, разделенных символом амперсанда (&). Если в URI включено несколько аргументов команды, символ амперсанда (&) должен отделять каждый аргумент команды от следующего аргумента команды. Аргументы команды зависят от сценария.
Аргументы команды
В схему URL-адреса Sway можно включить несколько аргументов команды. Эти аргументы команды не требуются. Если не включить аргументы команды, вызывается Sway приложение.
| Имя аргумента команды | Описание | Тип | Возможные значения | Обязательный? |
|---|---|---|---|---|
| id | Уникальный идентификатор Sway. Используется для указания открываемого Sway. | String | Допустимый уникальный идентификатор для Sway. Идентификатор всегда является частью URL-адреса Sway. Например, для следующего Sway https://sway.com/dBheQgVZ1RQBfiQUидентификатор имеет значение dBheQgVZ1RQBfiQU.Если учетная запись пользователя, связанная с приложением Sway, имеет разрешения на изменение, приложение открывает Sway в режиме редактирования. В противном случае приложение открывает Sway в режиме просмотра. |
Нет |
| <режим> | Режим, в котором необходимо открыть определенную Sway, как для редактирования, так и для просмотра. | String | edit представление ПРИМЕЧАНИЕ. Если идентификатор не указан, этот аргумент команды игнорируется. |
Нет |
| auth_upn | Учетная запись, используемая при открытии Sway. | String | Допустимый адрес электронной почты. Если указанный адрес электронной почты не связан с учетной записью Sway, Sway просит пользователя войти в систему в качестве указанного пользователя. Если с приложением Sway связано несколько учетных записей и существует указанный адрес электронной почты, приложение Sway переключается на использование этой учетной записи при вызове. |
Нет |
| auth_pvr | Тип учетной записи, используемой для открытия Sway: учетная запись Майкрософт или учетная запись Microsoft Entra ID. | String | WindowsLiveId — указывает, что учетная запись auth_upn является учетной записью Майкрософт. OrgId — указывает, что учетная запись auth_upn является учетной записью Microsoft Entra. Если auth_upn не указан, этот аргумент команды игнорируется. |
Нет |
| invoking_app | Имя приложения Windows, используемого для вызова Sway. | String | Понятное имя приложения Windows, используемого для вызова Sway через схему URL-адреса Sway. Этот аргумент команды предназначен для телеметрии и отслеживания. |
Нет |
Семантика схемы URI
Схема <ms-sway> определяет синтаксис URI для открытия Sway или вызова приложения Sway. Схема определяет несколько аргументов команд, которые можно использовать для выполнения следующих действий:
Откройте приложение Sway — аргументы команды указывать не нужно.
Откройте Sway для просмотра в приложении Sway . Необходимо указать идентификатор и режим, заданные для просмотра.
Откройте Sway для редактирования в приложении Sway . Необходимо указать идентификатор и режим редактирования. Рекомендуется также включить auth_upn и auth_pvr, чтобы убедиться, что при открытии Sway используется правильная учетная запись с разрешениями на редактирование.
Пример
ms-sway:id=CyrvEYLmFKi1B2_I&auth_upn=account@email.com&auth_pvr=WindowsLiveId&invoking_app=MyApp