Teams JavaScript 클라이언트 라이브러리란?
Teams 개발 플랫폼은 Teams JavaScript 클라이언트 라이브러리를 클라이언트 애플리케이션용 JavaScript 라이브러리로 제공합니다. 라이브러리는 Teams API를 사용하여 기능 및 기능을 Teams 애플리케이션에 통합할 수 있는 JavaScript 함수 컬렉션입니다. 기능 및 기능은 Teams 클라이언트에 기본으로 표시됩니다. 라이브러리를 사용하면 빌드하는 애플리케이션이 Teams 사용자에게 일관되고 사용자에게 친숙한 환경을 제공합니다.
이 단원에서는 애플리케이션에서 라이브러리를 사용하는 방법을 알아봅니다.
앱에 라이브러리 가져오기
애플리케이션에 라이브러리를 설치할 수 있는 다양한 방법을 살펴보겠습니다.
npm 또는 yarn을 사용하여 Teams JavaScript 클라이언트 라이브러리의 LTS 버전을 설치할 수 있습니다.
npm을 사용하여 라이브러리를 설치하려면 다음을 수행합니다.
npm install --save @microsoft/teams-js
yarn을 사용하여 라이브러리를 설치하려면 다음을 수행합니다.
yarn add @microsoft/teams-js
번들러를 사용하지 않고 웹앱을 빌드하는 경우 콘텐츠 배달 네트워크에서 직접 라이브러리를 로드할 수 있습니다. 웹앱에 다음 코드 조각을 추가합니다.
<script src="https://res.cdn.office.net/teams-js/2.7.1/js/MicrosoftTeams.min.js "></script>
라이브러리를 사용하는 방법
Teams JavaScript 클라이언트 라이브러리에는 논리적으로 기능으로 그룹화된 API가 있습니다. 이러한 기능은 라이브러리 내의 네임스페이스입니다. 최상위 네임스페이스 앱에는 전체 앱 사용에 필요한 모든 API가 포함되어 있습니다.
를 사용하여 app.Initialize()라이브러리를 초기화할 수 있습니다. 라이브러리가 초기화되면 네임스페이스를 사용하여 라이브러리에 포함된 모든 API 및 기능에 액세스할 수 있습니다. 앱의 기본 컨텍스트 정보를 얻으려면 를 호출합니다 app.getContext(). 사용자가 공유할 정보에 대한 복사 가능한 링크를 생성하고 표시하려면 를 호출 pages.shareDeepLink()합니다.
앱의 컨텍스트 정보를 얻으려면 다음 코드를 실행합니다.
await app.initialize();
const context = await app.getContext();
Microsoft Teams에 대한 컨텍스트 정보를 가져오면 Teams 앱이 사용자에게 더 나은 맞춤형 환경을 제공하는 데 도움이 됩니다. 예를 들어 컨텍스트 정보를 사용하여 앱은 Teams 또는 브라우저, 팀 또는 채널 또는 앱이 상호 작용하는 사용자와 같이 실행 중인 특정 환경을 이해할 수 있습니다. 이러한 인사이트는 사용자에게 관련되고 사용자 지정된 기능 또는 기능을 적절하게 구성하고 표시하는 방법을 결정하는 데 유용합니다.
기능
SDK의 API는 논리적으로 그룹화되며 기능이라고 합니다. 기능의 예로는 채팅, 대화 상자 및 인증이 있습니다. 각 기능에는 고유한 네임스페이스가 있습니다. 예를 들어 채팅, 대화 상자 또는 페이지가 있습니다.
참고
Teams JavaScript 클라이언트 라이브러리 버전 2.0.0 이상을 사용하면 Teams 앱을 Outlook 및 Office.com 같은 다른 호스트 앱에서 실행할 수 있습니다. 이러한 확장성 기능은 현재 이러한 앱에서 미리 보기로 제공됩니다.
Microsoft Teams를 앱의 현재 호스트로 생각하세요. 호스트에는 앱에 통합할 수 있는 몇 가지 기능이 있습니다. 예를 들어 앱은 Microsoft Teams 채팅 기능의 기능을 호출 chat.openChat() 하여 새 채팅을 시작할 수 있습니다. 그러면 사용자와 새 1:1 채팅이 열립니다.
각 기능에 대한 함수를 사용하여 <the-capability>.isSupported() 호스트에서 기능을 지원하는지 여부를 확인할 수 있습니다. 예를 들어 를 호출하기 chat.openChat()전에 앱이 실행 중인 호스트 앱에서 채팅이 지원되는지 여부를 확인할 수 있습니다. 확인하려면 함수 chat.isSupported()를 호출합니다. 채팅이 지원되고 채팅이 지원 false 되지 않는 경우 반환 true 됩니다. 이 검사를 통해 앱은 호스트 앱에서 지원되는 기능만 실행할 수 있으므로 사용자는 각 호스트에서 보다 자연스러운 환경을 경험할 수 있습니다.