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 비즈니스 메시지 보내기 및 받기 |
언어 및 게시 위치
개별 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 자동(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
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를 시작하려면 다음을 수행하세요.
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기