Краткое руководство: персонализация вашего приложения (HTML)

Статья
12/12/2015

[ Эта статья адресована разработчикам приложений среды выполнения Windows для Windows 8.x и Windows Phone 8.x. При разработке приложений для Windows 10 см. раздел последняя документация]

Ваше приложение среды выполнения Windows на JavaScript может использовать пакет Live SDK для получения доступа к учетной записи Майкрософт пользователя.

При запуске приложения пользователь сможет войти со своей учетной записью Майкрософт и разрешить приложению работать с личными данными. После того как пользователь выполнит вход и даст согласие, приложение сможет получать доступ к данным профиля пользователя для персонализации взаимодействия с ним.

Важно Это краткое руководство служит исключительно для демонстрационных и иллюстративных целей. Для использования этого компонента в приложении, которое предполагается отправить в Магазин Windows для распространения, в него необходимо включить не только возможность выхода и заявление о конфиденциальности, но и возможность входа. После этого краткого руководства прочтите Требования для входа с учетной записью Майкрософт, чтобы узнать, как добавить эти возможности.

Важно В учебнике по данному разделу показано приложение Магазина Windows. В приложение магазина Windows Phone можно также добавить службы Майкрософт.

Необходимые условия

Перед разработкой приложения среды выполнения Windows на JavaScript, использующего службы Windows Live, следует установить необходимое программное обеспечение на используемом для разработки компьютере.

Средства и SDK для разработки приложений Магазина Windows, если они еще не установлены. В набор средств входят Microsoft Visual Studio и прочие средства.
Live SDK.
Приложение Магазина Windows на JavaScript.

Примечание Код, показанный в этом кратком руководстве, добавляется в шаблон Пустое приложение для проектов JavaScript в Visual Studio.

Выполнение входа пользователя и получение его согласия на доступ к его данным

Добавьте код, выполняющий доступ к возможностям служб Windows Live.

При запуске приложения оно может отобразить элемент управления Windows для входа пользователя с помощью его учетной записи Майкрософт. После входа, если пользователь еще не дал согласие для этого приложения, ему будет предложено дать согласие на доступ приложения к сведениям его профиля.

Чтобы обеспечить вход пользователя во время работы приложения, сделайте следующее в своем проекте.

Добавьте ссылку на пакет Live SDK, как показано ниже.
1. В обозревателе решений щелкните правой кнопкой мыши Ссылки > Добавить ссылку....
2. Перейдите в раздел Windows > Расширения и установите флажок рядом с Live SDK. Если в списке нет Live SDK, переустановите Live SDK и начните процедуру заново.
3. Нажмите кнопку ОК, чтобы закрыть диалоговое окно.
Добавьте ссылку на файл wl.js в файле Live SDK вашего приложения. В шаблоне Пустое приложение для проектов JavaScript она добавляется в Default.html.

В тег <head> файла основного кода приложения и над ссылкой на файл default.js добавьте тег <script> следующим образом.
```
<script src="///LiveSDKHTML/js/wl.js"></script>
```

В тег <body> файла default.html добавьте код для входа пользователя в его учетную запись Майкрософт и обновления экрана с информацией пользователя.

Примечание При этом элемент управления для входа в учетную запись Майкрософт не будет отображаться, если учетная запись компьютера пользователя связана с его учетной записью Майкрософт. В этом случае вход в приложение будет осуществляться автоматически.

Добавьте следующий код в тег <body>.

<!--This is where the user's info will be written
 after the user has signed in.-->
<label id="info"></label>

<!--This is the script code that will sign the user in
 and display their name.-->
<script>
    // Initialize the Live Connect features.
    //  This should be called from each file that 
    //  uses Live Connect features.
    WL.init();

    // Sign the user into their Microsoft account or connect 
    //  the app to the Microsoft account the user has associated 
    //  with their computer account.
    WL.login({
            scope: ["wl.signin"]
        }).then(
            function (response) {
                onLoginComplete();
            },
            function (loginError) {
                document.getElementById("info").innerText =
                   "Login Error: " + loginError.error + " - " + loginError.error_description;
            }
        );

    // If the user is signed in, then get their profile info
    function onLoginComplete() {
        WL.api({
            path: "me",
            method: "get"
        }).then(
            function (response) {
                // update the display to show the user's name
                document.getElementById("info").innerText =
                    "Hello " + response.name + "!";
            },
            function (infoError) {
                document.getElementById("info").innerText =
                    "Data Request Error: " + infoError.error.message;
            }
        );
    }
</script>

Краткая сводка и дальнейшие действия

В этом разделе вы узнали, как начать использовать службы Windows Live в своем приложении для доступа к данным пользователя в таких облачных службах Майкрософт, как Outlook.com и Microsoft OneDrive.

Дополнительные сведения об использовании Windows Live см. в разделах Требования для входа с учетной записью Майкрософт и Добавление служб Майкрософт в приложение, в которых описывается добавление функций входа и выхода и заявления о конфиденциальности.

Краткое руководство: персонализация вашего приложения (HTML)

Необходимые условия

Выполнение входа пользователя и получение его согласия на доступ к его данным

Краткая сводка и дальнейшие действия

Дополнительные ресурсы