次の方法で共有

.NET 用 Azure Web PubSub イベント ハンドラー イベント データ モデル クライアント ライブラリ - バージョン 1.2.0

  • [アーティクル]

このライブラリでは、Azure Web PubSub サービスのアップストリーム要求で処理するクラスを定義します。

作業の開始

パッケージをインストールする

NuGet からクライアント ライブラリをインストールします:

dotnet add package Microsoft.Azure.WebPubSub.Common

前提条件

クライアントを認証する

ライブラリには適用されません。 クライアント ライブラリを使用して、サービス要求をわかりやすい方法で逆シリアル化する必要があります。

主要な概念

イベント

Connect、Connected、Disconnected は、接続ステージを示すシステム イベントです。 Connect は、サービスが応答を待機して次のアクションを決定するブロック イベントです。 返されたエラーは接続を削除します。

ユーザー イベントはメッセージ イベントです。 また、どのサービスが応答を待機しているブロック イベントでもあります。 サーバーは、呼び出し元に直接送信される応答で情報を返すことができます。

WebPubSubEventRequest

WebPubSubEventRequest は、サービス側からの抽象要求を表します。 詳細については、ValidationRequest、または ConnectEventRequest、ConnectedEventRequest、UserEventRequest、DisconnectedEventRequest の 4 つのイベントのいずれかである必要があります。 ValidationRequest は、 不正使用保護の要求を表します。

WebPubSubEventResponse

WebPubSubEventResponse は、抽象応答をサービスに返す必要があることを表します。 詳細には、EventErrorResponse、または ConnectEventResponse と UserEventResponse の 2 つのブロック イベントのいずれかである必要があります。

例

例を使用して、E2E の Microsoft.Azure.WebPubSub.AspNetCore を確認します。

トラブルシューティング

また、サービスに対して行う要求の詳細を確認する場合は、コンソールのログ記録を簡単に有効にすることもできます。

次のステップ

このライブラリの使用方法の詳細な例については、 サンプル ディレクトリを参照してください。

共同作成

このプロジェクトでは、共同作成と提案を歓迎しています。 ほとんどの共同作成では、共同作成者使用許諾契約書 (CLA) にご同意いただき、ご自身の共同作成内容を使用する権利を Microsoft に供与する権利をお持ちであり、かつ実際に供与することを宣言していただく必要があります。 詳細については、 https://cla.microsoft.com を参照してください。

pull request を送信すると、CLA を提供して PR (ラベル、コメントなど) を適宜装飾する必要があるかどうかを CLA ボットが自動的に決定します。 ボットによって提供される手順にそのまま従ってください。 この操作は、Microsoft の CLA を使用するすべてのリポジトリについて、1 回だけ行う必要があります。

このプロジェクトでは、[Microsoft Open Source Code of Conduct][code_of_conduct] が採用されています。 詳細については、[行動規範に関する FAQ][code_of_conduct_faq] を参照するか、その他の質問やコメントに問い合わせてください opencode@microsoft.com 。

インプレッション数