91 lines
4.1 KiB
Markdown
91 lines
4.1 KiB
Markdown
---
|
|
page_type: sample
|
|
products:
|
|
- office-sp
|
|
- skype
|
|
- office-skype-business
|
|
languages:
|
|
- javascript
|
|
- typescript
|
|
extensions:
|
|
contentType: samples
|
|
technologies:
|
|
- SharePoint Framework
|
|
platforms:
|
|
- react
|
|
createdDate: 12/1/2017 12:00:00 AM
|
|
---
|
|
# Skype Status
|
|
|
|
## Summary
|
|
This sample demonstrates how to use the *UCWA JS SDK* for skype with the SharePoint Framework. It shows how to subscribe to status change of the different people of the organization but you can get much more information, checkout the [documentation](https://msdn.microsoft.com/en-us/skype/websdk/docs/generalreference?f=255&MSPPError=-2147217396)
|
|
It allows leverages the *Office UI Fabric* Persona card to display comprehensive information about the user.
|
|
|
|
Allows you to properly display and subscribe to change of users' availability.
|
|
See the demo:
|
|
![demo](./images/demo.gif)
|
|
|
|
## Used SharePoint Framework Version
|
|
![drop](https://img.shields.io/badge/drop-GA-green.svg)
|
|
|
|
## Applies to
|
|
|
|
* [SharePoint Framework Developer](https://docs.microsoft.com/sharepoint/dev/spfx/sharepoint-framework-overview)
|
|
* [Office 365 developer tenant](https://docs.microsoft.com/sharepoint/dev/spfx/set-up-your-developer-tenant)
|
|
|
|
## Solution
|
|
|
|
Solution|Author(s)
|
|
--------|---------
|
|
react-skype-status|[Vincent Biret](https://github.com/baywet)
|
|
|
|
|
|
## Version history
|
|
|
|
Version|Date|Comments
|
|
-------|----|--------
|
|
1.4|March 27th, 2019|Upgrade to SPFx 1.8.0
|
|
1.3|November 18th, 2018|Upgrade to SPFx 1.7.0
|
|
1.2|July 4th, 2018|Fixed a bug when subscribing to the current user's status
|
|
1.1|June 25th, 2018|Upgrade to 1.5
|
|
1.0|December 1, 2017|Initial release
|
|
|
|
## Disclaimer
|
|
|
|
**THIS CODE IS PROVIDED *AS IS* WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.**
|
|
|
|
---
|
|
|
|
## Minimal Path to Awesome
|
|
### Authentication
|
|
Because the Skype API's are secured, you first need to register an Azure Active Directory application.
|
|
To do that go to `portal.azure.com` and sign in as your tenant administrator.
|
|
![azure active directory](./images/1.PNG)
|
|
Click on `Azure Active Directory`.
|
|
![app registrations](./images/2.PNG)
|
|
Click on on `App Registrations` and then `New Application Registration`
|
|
![app details entry](./images/3.PNG)
|
|
Enter any name, select `Web app / API` in `Application Type` and in `Sign-In URL` enter `https://*.sharepoint.com/*`, then click on `Create`
|
|
![app details display](./images/4.PNG)
|
|
Take note of the `application ID`, we'll need it later. Click on `required permissions`.
|
|
![skype permission](./images/5.PNG)
|
|
Click on `add` then `select an API` and select `Skype for Business`.
|
|
![skype scopes](./images/6.PNG)
|
|
Select under `delegated permissions` both `Read/Write Skype user contacts and groups`, `Read/Write Skype user information (preview)`, `Receive conversation invites (preview)` (the receive conversation permission is required to get access to the mePerson object and have access to the current user's presence information) then click `select`. Finish by clicking `Done`.
|
|
![grant permission](./images/7.PNG)
|
|
Don't forget to click on `Grant permissions` and `yes`.
|
|
|
|
### Updating the app
|
|
After copying that sample to your local machine and running `npm install` to install the depenencies, `/src/webparts/skypePresence/services/Constants.ts` open your favorite editor. Make sure you replace the value of `ApplicationIdKey` to the value application id we kept earlier.
|
|
|
|
### Deploying the application
|
|
Start by running `gulp package-solution` and deploy the application to the app catalog. More information on how to do it [here](https://docs.microsoft.com/en-us/sharepoint/dev/spfx/web-parts/get-started/serve-your-web-part-in-a-sharepoint-page)
|
|
**At the end select SkypePresence web part instead**
|
|
Don't forget to run `gulp serve --nobrowser` to start the debugging server.
|
|
|
|
### Addtional page required
|
|
Because Skype needs to silently redirect the user to a page for the authentication flow, you need to create an additional page called `skypepresence` in your site.
|
|
You don't need to add anything on that page.
|
|
|
|
![tracking image](https://telemetry.sharepointpnp.com/sp-dev-fx-webparts/samples/react-skype-status)
|