SDK と REST API
Azure Communication Services 機能は、機能領域に基づいて、概念的に個別の領域に分類されています。 ほとんどの領域には、インターネット経由で直接使用できる、公開された REST API に対してプログラミングされた、完全にオープンソースである SDK があります。 Calling SDK は独自のネットワーク インターフェイスを使用しており、クローズ ドソースです。
下の表では、これらの領域と、REST API と SDK ライブラリの可用性についてまとめています。 また、API と SDK がエンドユーザー クライアント向けか、信頼できるサービス環境向けかについても記載しています。 SMS などの API には、信頼度の低い環境にあるエンドユーザーのデバイスから直接アクセスしないようにしてください。
通話およびチャット アプリケーションの開発は、Azure Communication Services UI ライブラリによって迅速化できます。 このカスタマイズ可能な UI ライブラリは、Web アプリとモバイル アプリ用のオープンソース UI コンポーネントと、Microsoft Teams のテーマを提供しています。
SDK
| アセンブリ | プロトコル | 環境 | 機能 |
|---|---|---|---|
| Azure Resource Manager | REST | サービス | Communication Services のリソースをプロビジョニングおよび管理します |
| 共通 | 該当なし | クライアントとサービス | 他の SDK の基本型を指定します |
| ID | REST | サービス | ユーザーを管理し、トークンにアクセスします |
| 電話番号 | REST | サービス | 電話番号を取得して管理します |
| SMS | REST | サービス | SMS メッセージを送信および受信する |
| 電子メール | REST | サービス | メール メッセージの送信と状態の取得 |
| チャット | 独自の通知を含む REST | クライアントとサービス | リアルタイムのテキスト チャットをアプリケーションに追加します |
| 通話 | 独自の転送 | クライアント | 音声、ビデオ、画面共有、および他のリアルタイム通信 |
| 呼び出し自動化 | REST | サービス | PSTN および VoIP 通話用にカスタマイズされた通話ワークフローを構築する |
| Job Router | REST | サービス | さまざまなアプリケーションにわたって顧客との対話の管理を最適化する |
| ネットワーク トラバーサル | REST | サービス | TURN サーバーへのアクセスによる低レベルのデータ転送 |
| 部屋 | REST | サービス | 構造化されたコミュニケーション ルームの作成と管理 |
| UI ライブラリ | 該当なし | クライアント | チャットおよび通話アプリ用の運用環境対応 UI コンポーネント |
言語と公開場所
以下では、個々の SDK パッケージの公開場所について説明します。
| 面グラフ | JavaScript | .NET | Python | Java SE | iOS | Android | その他 |
|---|---|---|---|---|---|---|---|
| Azure Resource Manager | npm | NuGet | PyPi | Maven | - | - | GitHub 経由の Go |
| 共通 | npm | NuGet | 該当なし | Maven | GitHub | Maven | - |
| ID | npm | NuGet | PyPi | Maven | - | - | - |
| 電話番号 | npm | NuGet | PyPi | Maven | - | - | - |
| チャット | npm | NuGet | PyPi | Maven | GitHub | Maven | - |
| SMS | npm | NuGet | PyPi | Maven | - | - | - |
| 電子メール | npm | NuGet | PyPi | Maven | - | - | - |
| 通話 | npm | NuGet | - | - | CocoaPods | Maven | - |
| 呼び出し自動化 | npm | NuGet | PyPi | Maven | |||
| Job Router | npm | NuGet | PyPi | Maven | |||
| ネットワーク トラバーサル | npm | NuGet | PyPi | Maven | - | - | - |
| 部屋 | npm | NuGet | PyPi | Maven | - | - | - |
| UI ライブラリ | npm | - | - | - | GitHub | GitHub | GitHub、Storybook |
| Advanced Messaging | - | NuGet | - | - | - | - | - |
| リファレンス ドキュメント | docs | docs | docs | docs | docs | docs | - |
SDK プラットフォーム サポートの詳細
Android Calling SDK のサポート
- Android API レベル 21 以上のサポート
- Java 7 以上のサポート
- Android Studio 2.0 のサポート
- Android Auto (AAOS) および Android を実行している IoT デバイスは現在サポートされていません
iOS Calling SDK のサポート
- ビルド時の iOS 10.0 以上と実行時の iOS 12.0 以上のサポート
- Xcode 12.0 以上
- iPadOS 13.0 以降のサポート
.NET
呼び出しでは、以下に示したプラットフォームがサポートされています。
- .NET ネイティブまたは C++/WinRT を使用した UWP
- Windows 10/11 10.0.17763 - 10.0.22621.0
- Windows Server 2019/2022 10.0.17763 - 10.0.22621.0
- .NET 6 を使用した WinUI3
- Windows 10/11 10.0.17763.0 - net6.0-windows10.0.22621.0
- Windows Server 2019/2022 10.0.17763.0 - net6.0-windows10.0.22621.0
その他の Communication Services パッケージはすべて、下に示したプラットフォームをサポートしている .NET Standard 2.0 を対象としています。
- .NET Framework 4.6.1 を介したサポート
- Windows 10、8.1、8、7
- Windows Server 2012 R2、2012、2008 R2 SP1
- .NET Core 2.0 を介したサポート:
- Windows 10 (1607 以降)、7 SP1+、8.1
- Windows Server 2008 R2 SP1+
- Max OS X 10.12 以降
- Linux の複数のバージョン/ディストリビューション
- UWP 10.0.16299 (RS3) 2017 年 9 月
- Unity 2018.1
- Mono 5.4
- Xamarin iOS 10.14
- Xamarin Mac 3.8
REST API
Communication Services API は、他の Azure REST API と共に説明されています。 このドキュメントでは、HTTP メッセージを構成する方法と、Postman を使用するためのガイダンスが提供されます。 REST インターフェイス ドキュメントは GitHub で Swagger 形式でも公開されています。 個々の API のスロットル制限は、サービスの制限に関するページで確認できます。
API の安定性に関する想定
重要
このセクションでは、安定とマークされている REST API および SDK に関するガイダンスを提供します。 プレリリース、プレビュー、またはベータとマークされている API は、予告なしに変更されたり非推奨になったりする場合があります。
将来的に、Communication Services SDK のバージョンが廃止される可能性があります。また、REST API とリリースされた SDK に対して破壊的変更が加えられる可能性があります。 Azure Communication Services は、サービス バージョンの廃止に関して、"通常は" 次の 2 つのサポート ポリシーに従います。
- Communication Services インターフェイスの変更に起因するコードの変更を求められる場合、お客様は少なくとも 3 年前に通知されます。 通常、ドキュメントに記載されているすべての REST API と SDK API では、インターフェイスが使用停止になる前に少なくとも 3 年間警告が発生します。
- お客様は、SDK アセンブリを最新のマイナー バージョンに更新する必要が生じる少なくとも 1 年前に通知されます。 これらの必須の更新は、同じメジャー バージョンに含まれているため、コードを変更する必要はありません。 最新の SDK を使用することは、セキュリティとパフォーマンスに関する更新を頻繁に必要とするリアルタイム コンポーネントである Calling および Chat ライブラリにとって特に重要です。 すべての Communication Services SDK を最新の状態に保つことを強くお勧めします。
API と SDK の廃止の例
v24 バージョンの SMS REST API をアプリケーションに統合しました。 Azure Communication では v25 がリリースされています。
これらの API の機能が停止し、v25 に強制的に更新される前に、3 年間警告が表示されます。 この更新ではコードの変更が必要になる場合があります。
v2.02 バージョンの Calling SDK をアプリケーションに統合しました。 Azure Communication では v2.05 がリリースされています。
v2.05 バージョンの Calling SDK への更新を、v2.05 のリリースから 12 か月以内に求められる場合があります。 これはコードを変更せず、成果物を単に置き換えるだけで済みます。v2.05 は v2 メジャー バージョンに含まれ、破壊的変更はないためです。
次のステップ
詳細については、次の SDK の概要を参照してください。
Azure Communication Services の使用を開始するには: