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 Resource Manager REST 서비스 Communication Services 리소스 프로비전 및 관리
공통 해당 없음 클라이언트 및 서비스 다른 SDK의 기본 형식을 제공합니다.
ID REST 서비스 사용자, 액세스 토큰 관리
전화번호 REST 서비스 전화 번호 가져오기 및 관리
SMS REST 서비스 SMS 메시지 보내기 및 받기
전자 메일 REST 서비스 이메일 메시지 상태 보내기 및 받기
채팅 소유 신호를 포함하는 REST 클라이언트 및 서비스 애플리케이션에 실시간 텍스트 기반 채팅 추가
통화 중 소유 전송 클라이언트 음성, 비디오, 화면 공유 및 기타 실시간 데이터 통신 기능 사용
통화 자동화 REST 서비스 PSTN 및 VoIP 통화에 사용자 지정된 통화 워크플로 빌드
작업 라우터 REST 서비스 다양한 애플리케이션에서 고객 상호 작용 관리 최적화
Network Traversal REST 서비스 낮은 수준의 데이터 전송에 대한 액세스 설정 서버
REST 서비스 구조화된 통신실 조성 및 관리
UI 라이브러리 해당 없음 클라이언트 채팅 및 통화 앱에 대한 프로덕션 준비 UI 구성 요소

언어 및 게시 위치

개별 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 - - GitHub Maven -
통화 자동화 npm NuGet PyPi Maven
작업 라우터 npm NuGet PyPi Maven
Network Traversal npm NuGet PyPi Maven - - -
npm NuGet PyPi Maven - - -
UI 라이브러리 npm - - - GitHub GitHub GitHub, 스토리 북
고급 메시지 - NuGet - - - - -
참조 설명서 docs docs docs docs docs docs -

SDK 플랫폼 지원 세부 정보

iOS 및 Android

  • 통신 서비스 iOS SDK 대상 iOS 버전 13 이상 및 Xcode 11 이상
  • Android Java SDK 대상 Android API 레벨 21 이상 및 Android Studio 4.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

기타 모든 통신 서비스 패키지는 아래 나열된 플랫폼을 지원하는 .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

통신 서비스 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를 시작하려면 다음을 수행하세요.