SDK 및 REST API
Azure Communication Services 기능은 기능 영역에 따라 개념상 불연속 영역으로 구성됩니다. 대부분의 영역에는 인터넷을 통해 직접 사용할 수 있는 게시된 REST API에 대해 프로그래밍된 완전한 오픈 소스 SDK가 있습니다. 호출하는 SDK는 소유 네트워크 인터페이스를 사용하며 닫혀 있는 소스입니다.
아래 표에는 이러한 영역 및 REST API 및 SDK 라이브러리의 가용성이 요약되어 있습니다. API 및 SDK가 최종 사용자 클라이언트나 신뢰할 수 있는 서비스 환경에서 사용되는지 확인합니다. SMS와 같은 API는 신뢰도가 낮은 환경의 최종 사용자 디바이스에서 직접 액세스해서는 안 됩니다.
통화 및 채팅 애플리케이션의 개발은 Azure Communication Services UI 라이브러리를 통해 가속화될 수 있습니다. 사용자 지정 가능한 UI 라이브러리는 웹/모바일 앱용 오픈 소스 UI 구성 요소와 Microsoft Teams 테마를 제공합니다.
최신 SDK를 사용하는 연습 만들기
브라우저 및 운영 체제는 최신의 향상된 기능을 지원하고 기존 버그를 수정하기 위해 지속적으로 진화하고 있습니다. 최신 Azure Communication Services SDK를 업데이트된 브라우저 및 운영 체제 업데이트와 함께 사용할 때 애플리케이션에 대한 최상의 전체 최종 사용자 환경을 달성할 수 있습니다. 최신 업데이트 Azure Communication Services SDK는 더 나은 성능, 보안, 호환성, 품질 및 유용성과 같은 많은 이점을 제공합니다. 업데이트하면 브라우저 및 운영 체제에 정기적으로 추가되는 최신 기능 및 업데이트에 액세스할 수 있습니다. Azure Communication Services SDK는 자주 업데이트됩니다(약 6주마다~분기별 1회). 항상 가장 최근 SDK로 업데이트하도록 하는 프로세스를 만드는 것이 좋습니다.
SDK
| 어셈블리 | 프로토콜 | 환경 | 기능 |
|---|---|---|---|
| Azure Resource Manager | REST | 서비스 | Communication Services 리소스 프로비전 및 관리 |
| 공통 | 해당 없음 | 클라이언트 및 서비스 | 다른 SDK의 기본 형식을 제공합니다. |
| ID | REST | 서비스 | 사용자, 액세스 토큰 관리 |
| 전화번호 | REST | 서비스 | 전화 번호 가져오기 및 관리 |
| SMS | REST | 서비스 | SMS 메시지 보내기 및 받기 |
| 전자 메일 | REST | 서비스 | 이메일 메시지 상태 보내기 및 받기 |
| 채팅 | 소유 신호를 포함하는 REST | 클라이언트 및 서비스 | 애플리케이션에 실시간 텍스트 기반 채팅 추가 |
| 통화 중 | 소유 전송 | 클라이언트 | 음성, 비디오, 화면 공유 및 기타 실시간 데이터 통신 기능 사용 |
| 통화 자동화 | REST | 서비스 | PSTN 및 VoIP 통화에 사용자 지정된 통화 워크플로 빌드 |
| 작업 라우터 | REST | 서비스 | 다양한 애플리케이션에서 고객 상호 작용 관리 최적화 |
| 룸 | REST | 서비스 | 구조화된 통신실 조성 및 관리 |
| UI 라이브러리 | 해당 없음 | 클라이언트 | 채팅 및 통화 앱에 대한 프로덕션 준비 UI 구성 요소 |
| 고급 메시지 | REST | 서비스 | WhatsApp 비즈니스 메시지 보내기 및 받기 |
언어 및 게시 위치
개별 SDK 패키지의 게시 위치는 다음과 같습니다.
| 지역 | JavaScript | .NET | Python | Java SE | iOS | Android | 기타 |
|---|---|---|---|---|---|---|---|
| Azure Resource Manager | npm | NuGet | PyPi | Maven | - | - | GitHub를 통해 이동 |
| 공통 | 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 | |||
| 작업 라우터 | npm | NuGet | PyPi | Maven | |||
| 룸 | npm | NuGet | PyPi | Maven | - | - | - |
| UI 라이브러리 | npm | - | - | - | GitHub | GitHub | GitHub, 스토리 북 |
| 고급 메시지 | npm | NuGet | PyPi | Maven | - | - | - |
| 참조 설명서 | docs | docs | docs | docs | docs | docs | - |
SDK 플랫폼 지원 세부 정보
Android Calling SDK 지원
- Android API 수준 21 이상 지원
- Java 7 이상 지원
- Android Studio 2.0 지원
Android 플랫폼 지원
Android 에코시스템은 다양한 유형의 디바이스를 위해 설계된 다양한 버전 및 특수 플랫폼을 광범위하게 포괄합니다. 다음 표에는 현재 지원되는 Android 플랫폼이 나와 있습니다.
| 장치 | 설명 | 지원 |
|---|---|---|
| 휴대폰 및 태블릿 | Android Commercial을 실행하는 표준 디바이스. | 비디오 해상도로 완전히 지원됩니다. |
참고 항목
휴대폰 및 태블릿에서만 화상 통화를 지원할 수 있습니다. 비표준 디바이스 또는 플랫폼(예: 스마트 안경 또는 사용자 지정 디바이스)의 비디오와 관련된 사용 사례의 경우 개발 프로세스 초기에 저희에게 문의하여 가장 적합한 통합 접근 방식을 결정하는 데 도움을 얻으세요.
구현 중에 문제가 발견되면 문제 해결 가이드를 참조하는 것이 좋습니다.
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
SDK 패키지 크기
| SDK | 압축 크기(MB) | 압축을 푼 크기(MB) |
|---|---|---|
| iOS SDK | ARM64 - 17.1MB | ARM64 - 61.1MB |
| Android SDK | x86 - 13.3MB | x86 - 33.75MB |
| x86_64 - 13.3MB | x86_64 - 35.75MB | |
| ARM64-v8a - 13.1MB | ARM64-v8a - 37.02MB | |
| armeabi-v7a - 11.4MB | armeabi-v7a - 23.97MB |
앱을 개선하고자 하는 경우 모범 사례 문서를 읽어 보면 좋습니다. 이 문서에서는 앱을 릴리스하기 전에 검토할 권장 사항 및 체크리스트를 제공합니다.
REST API
통신 서비스 API는 다른 Azure REST API와 함께 설명됩니다. 이 설명서에서는 HTTP 메시지를 구성하는 방법을 설명하고 Postman 사용에 대한 지침을 제공합니다. REST 인터페이스 설명서는 GitHub에서 Swagger 형식으로도 게시됩니다. 서비스 제한 페이지에서 개별 API에 대한 제한 사항을 찾을 수 있습니다.
API 안정성 기대 수준
Important
이 섹션에서는 안정적인 것으로 표시된 REST API 및 SDK에 대한 지침을 제공합니다. 시험판, 미리 보기 또는 베타로 표시된 API는 통지 없이변경되거나 더 이상 사용되지 않을 수 있습니다.
향후에는 Communication Services SDK 버전의 사용을 중지할 수 있으며, REST API와 출시된 SDK에 대한 주요 변경 내용이 도입될 수 있습니다. Azure Communication Services는 일반적으로 서비스 버전 사용을 중지하기 위한 다음의 두 가지 지원 가능성 정책을 따릅니다.
- Communication Services 인터페이스 변경으로 인한 코드 변경을 요구하기 전에 3년 이상 알림이 표시됩니다. 문서화된 모든 REST API 및 SDK API는 일반적으로 인터페이스의 서비스가 해제되기 전에 3년 이상 경고를 발생시킵니다.
- SDK 어셈블리를 최신 부 버전으로 업데이트하기 전에 적어도 1년 동안 알림이 표시됩니다. 해당 필수 업데이트는 동일한 주 버전에 있기 때문에 코드를 변경할 필요가 없습니다. 보안 및 성능 업데이트가 자주 필요한 실시간 구성 요소인 통화 및 채팅 라이브러리에는 최신 SDK를 사용하는 것이 특히 중요합니다. 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의 릴리스 12개월 안에 호출 SDK의 V2.05 버전으로 업데이트해야 할 수 있습니다. v2.05는 v2 주 버전에 있고 호환성이 손상되는 변경이 없으므로 업데이트가 코드를 변경하지 않고 아티팩트를 대체합니다.
다음 단계
자세한 내용은 다음 SDK 개요를 참조하세요.
Azure Communication Services를 시작하려면 다음을 수행하세요.