다음을 통해 공유


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주마다 한 분기에 한 번). 항상 최신 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 Business 메시지를 보내고 받습니다.

언어 및 게시 위치

개별 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

Communication Services API는 다른 Azure REST API와 함께 문서화됩니다. 이 설명서에서는 HTTP 메시지를 구성하는 방법을 설명하고 Postman을 사용하기 위한 지침을 제공합니다. REST 인터페이스 설명서는 GitHub의 OpenAPI 형식 으로도 게시됩니다. 서비스 제한에서 개별 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를 시작하려면 다음을 수행하세요.