次の方法で共有

Sway URI スキーム

このドキュメントでは、Windows 用のSway アプリケーションの Uniform Resource Identifiers (URI) の形式を定義します。 この URI スキームを使用して、さまざまなコマンドを使用してSway アプリケーションを呼び出すことができます。

SWAY URI スキームの構文

URI スキームの構文を次に示します。

<ms-sway>:<command-argument>

  • <ms-sway>– Swayが呼び出すアプリケーションであることを示します。 Windows 用Swayがインストールされると、 ms-sway Sway ハンドラーとして Windows に登録されます。
  • <command-argument> – URI には、アンパサンド (&) 文字で区切られた 1 つ以上のコマンド引数が含まれる場合があります。 URI に複数のコマンド引数が含まれている場合、アンパサンド (&) 文字は各コマンド引数を次のコマンド引数から分離する必要があります。 コマンド引数はシナリオによって異なります。

コマンド引数

Sway URL スキームの一部として、いくつかのコマンド引数を含めることができます。 これらのコマンド引数は必要ありません。 コマンド引数を含まない場合は、Sway アプリケーションが呼び出されます。

コマンド引数名 説明 型 使用可能な値 必須
id Swayの一意識別子。 開くSwayを示すために使用します。 String Swayの有効な一意識別子。 ID は常に、Swayへの URL の一部です。

たとえば、次のSwayhttps://sway.com/dBheQgVZ1RQBfiQUの場合、id は ですdBheQgVZ1RQBfiQU。

Sway アプリケーションに関連付けられているユーザー アカウントに編集アクセス許可がある場合、アプリケーションは編集モードでSwayを開きます。 それ以外の場合、アプリケーションはビュー モードでSwayを開きます。		 不要
mode 特定のSwayを開くモード(編集用か表示用か)。 String edit
view

注: ID が指定されていない場合、このコマンド引数は無視されます。		 不要
auth_upn Swayを開くときに使用するアカウント。 String 有効なメール アドレス。

指定した電子メール アドレスがSway アカウントに関連付けられていない場合、Swayは、指定したユーザーとしてサインインするようにユーザーに求めます。

Sway アプリケーションに複数のアカウントが関連付けられている場合、指定したメール アドレスが存在する場合、Sway アプリケーションは呼び出されたときにそのアカウントの使用に切り替わります。		 不要
auth_pvr Swayを開くために使用するアカウントの種類 (Microsoft アカウントまたはMicrosoft Entra ID アカウント)。 String WindowsLiveId – auth_upn アカウントが Microsoft アカウントであることを指定します。

OrgId – auth_upn アカウントがMicrosoft Entra アカウントであることを指定します。

auth_upnが指定されていない場合、このコマンド引数は無視されます。		 不要
invoking_app Swayの呼び出しに使用される Windows アプリケーションの名前。 String Sway URL スキームを使用してSwayを呼び出すために使用される Windows アプリケーションのフレンドリ名。

このコマンド引数の目的は、テレメトリと追跡です。		 不要

URI スキーム セマンティクス

スキームは<ms-sway>、Swayを開く、またはSway アプリケーションを呼び出すための URI 構文を定義します。 スキームでは、いくつかのコマンド引数を定義します。これは、次の操作に使用できます。

  • Sway アプリケーションを開く – コマンド引数を指定する必要はありません。

  • Sway アプリケーションで表示するためのSwayを開きます。表示する ID とモードを指定する必要があります。

  • Sway アプリケーションで編集用のSwayを開く – 編集に設定された ID とモードを指定する必要があります。 auth_upnとauth_pvrも含め、Swayを開くときに編集アクセス許可を持つ適切なアカウントが使用されるようにすることをお勧めします。

例

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

  • Last updated on