audioRoutingGroup リソースの種類audioRoutingGroup resource type


Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでは、これらの API の使用はサポートされていません。Use of these APIs in production applications is not supported.

音声ルーティンググループでは、複数の参加者の間のプライベートオーディオルートをマルチパーティの会話に格納します。The audio routing group stores a private audio route between participants in a multiparty conversation. Source は参加者であり、受信者はマルチパーティの会話の他の参加者のサブセットです。Source is the participant itself and the receivers are a subset of other participants in the multiparty conversation.

注:ConfigureMixerには、すべてのルートは含まれません。送信元と受信側の組み合わせにボリュームレベルを設定するための呼び出し全体に対して使用されます。Note: ConfigureMixer does not involve any routes, it is for the entire call for setting the volume levels for source-receiver combinations.


メソッドMethod 戻り値の型Return Type 説明Description
AudioRoutingGroup を取得するGet audioRoutingGroup audioRoutingGroupaudioRoutingGroup AudioRoutingGroup オブジェクトのプロパティとリレーションシップを読み取ります。Read properties and relationships of audioRoutingGroup object.
UpdateUpdate audioRoutingGroupaudioRoutingGroup 受信者の一覧を更新します。Update receivers list.
DeleteDelete NoneNone オーディオルーティンググループを削除します。Delete the audio routing group.


プロパティProperty Type 説明Description
idid stringstring 読み取り専用です。Read-only. サーバーによって生成されます。Server generated.
配信receivers collection(string)collection(string) 受信側参加者 id のリスト。List of receiving participant ids.
routingModeroutingMode stringstring ルーティンググループモード。Routing group mode. 可能な値は、oneToOnemulticast です。Possible values are: oneToOne, multicast.
sourcessources collection(string)collection(string) ソース参加者 id のリスト。List of source participant ids.

注: ルーティングモードは、送信元と受信者に対する制限を決定します。Note: Routing mode determines the restrictions on the sources and receivers. 次のルーティンググループのみがサポートされています。Only the following routing groups are supported.

  • oneToOne-ソースと受信者には、それぞれ1人の参加者のみが含まれます。oneToOne - sources and receivers have only one participant each.
  • multicast-ソースには1つの参加者がいますが、複数の受信者がいます。multicast - source has one participant but there are multiple receivers. 受信者の一覧が更新された可能性があります。Receivers list may be updated.

注: 多数のオーディオルーティンググループ (参加者ごとに bot など) を作成する場合は、上位4台の主要なスピーカーのオーディオのみが転送されます。Note: If you create many audio routing groups (e.g. a bot per participant), only the audio of the top 4 dominant speakers is forwarded. カスタマイズされたオーディオルーティンググループを使用している場合でも、メインミキサーでスピーカーの音量が十分でない場合は、このスピーカーと bot のみに専用のオーディオグループがある場合でも、そのユーザーは bot によって聞くことはできません。It means even with customized audio routing group, if the speaker is not loud enough in the main mixer, he/she cannot be heard by the bot even if there is a private audio group just for this speaker and the bot.



JSON 表記JSON representation

リソースの JSON 表記を次に示します。The following is a JSON representation of the resource.

  "id": "string (identifier)",
  "receivers": [ "string" ],
  "routingMode": "oneToOne | multicast",
  "sources": [ "string" ]