Запуск Центра отзывов из приложенияLaunch Feedback Hub from your app

Вы можете подтолкнуть пользователей к тому, чтобы оставить отзыв, добавив элемент управления (например, кнопку) в приложение универсальной платофрмы Windows (UWP), который открывает Центр отзывов.You can encourage your customers to leave feedback by adding a control (such as a button) to your Universal Windows Platform (UWP) app that launches Feedback Hub. Центр отзывов — это предустановленное приложение, в котором собираются отзывы о Windows и установленных приложениях.Feedback Hub is a preinstalled app that provides a single place to gather feedback on Windows and installed apps. Все отзывы клиентов, отправленные для вашего приложения через центр обратной связи, собираются и отображаются в отчете о отзывах в центре партнеров, что позволяет просматривать проблемы, предложения и отзывы, отправленные клиентами в одном отчете.All customer feedback that is submitted for your app through Feedback Hub is collected and presented to you in the Feedback report in Partner Center, so you can see the problems, suggestions, and upvotes that your customers have submitted in one report.

Чтобы запустить Центр отзывов из вашего приложения, используйте API-интерфейс в пакете Microsoft Store Services SDK.To launch Feedback Hub from your app, use an API that is provided by the Microsoft Store Services SDK. Мы рекомендуем применять этот API для запуска Центра отзывов из элемента интерфейса в приложении, который соответствует нашим рекомендациям по оформлению.We recommend that you use this API to launch Feedback Hub from a UI element in your app that follows our design guidelines.

Примечание

Центр отзывов доступен только на устройствах под управлением версии 10.0.14271 или более поздней версии ОС Windows 10, основанной на настольном и мобильном семействах устройств.Feedback Hub is available only on devices that run version 10.0.14271 or later of a Windows 10 OS that is based on the desktop and mobile device families. Мы рекомендуем показывать элемент управления отзывами в приложении, только если Центр отзывов доступен на устройстве пользователя.We recommend that you show a feedback control in your app only if the Feedback Hub is available on the user's device. В этом разделе представлен пример кода, позволяющий реализовать это.The code in this topic demonstrates how to do this.

Запуск Центра отзывов из приложенияHow to launch Feedback Hub from your app

Запуск Центра отзывов из приложения:To launch Feedback Hub from your app:

  1. Установите пакет Microsoft Store Services SDK.Install the Microsoft Store Services SDK.
  2. Откройте проект в Visual Studio.Open your project in Visual Studio.
  3. В обозревателе решений щелкните правой кнопкой мыши узел Ссылки вашего проекта и выберите команду Добавить ссылку.In Solution Explorer, right-click the References node for your project and click Add Reference.
  4. В диалоговом окне Диспетчер ссылок разверните список Универсальная платформа Windows и выберите Расширения.In Reference Manager, expand Universal Windows and click Extensions.
  5. В списке пакетов SDK установите флажок рядом с пунктом Microsoft Engagement Framework и нажмите кнопку ОК.In the list of SDKs, click the check box next to Microsoft Engagement Framework and click OK.
  6. Добавьте в проект элемент управления, который позволит пользователям запустить Центр отзывов, например кнопку.In your project, add the control that you want to show to users to launch Feedback Hub, such as a button. Мы рекомендуем настроить этот элемент управления следующим образом.We recommend that you configure the control as follows:
  • Выберите для содержимого элемента управления шрифт Segoe MDL2 Assets.Set the font of the content shown in the control to Segoe MDL2 Assets.

  • Добавьте в текст элемента управления шестнадцатеричный код символа Юникода E939.Set the text in the control to the hexadecimal Unicode character code E939. Это код символа рекомендуемого значка отзыва в шрифте Segoe MDL2 Assets.This is the character code for the recommended feedback icon in the Segoe MDL2 Assets font.

  • Скройте элемент управления.Set the visibility of the control to hidden.

    Примечание

    Мы рекомендуем скрывать элемент управления отзывами по умолчанию и показывать его в коде инициализации, только если Центр отзывов доступен на устройстве пользователя.We recommend that you hide your feedback control by default and show it in your initialization code only if the Feedback Hub is available on the user's device. Далее показано, как это сделать.The next step demonstrates how to do this.

    В следующем примере кода демонстрируется XAML-определение кнопки, которая настроена, как показано выше.The following code demonstrates the XAML definition of a Button that is configured as described above.

    <Button x:Name="feedbackButton" FontFamily="Segoe MDL2 Assets" Content="&#xE939;" HorizontalAlignment="Left" Margin="138,352,0,0" VerticalAlignment="Top" Visibility="Collapsed"  Click="feedbackButton_Click"/>
    
  1. В коде инициализации страницы приложения, на которой размещен элемент управления отзывами, используйте статический метод IsSupported класса StoreServicesFeedbackLauncher, чтобы определить, доступен ли Центр отзывов на устройстве пользователя.In your initialization code for the app page that hosts your feedback control, use the static IsSupported method of the StoreServicesFeedbackLauncher class to determine whether the Feedback Hub is available on the user's device. Центр отзывов доступен только на устройствах под управлением версии 10.0.14271 или более поздней версии ОС Windows 10, основанной на настольном и мобильном семействах устройств.Feedback Hub is available only on devices that run version 10.0.14271 or later of a Windows 10 OS that is based on the desktop and mobile device families.

    Если это свойство возвращает значение true, сделайте элемент управления видимым.If this property returns true, make the control visible. В следующем примере кода показано, как это сделать для кнопки.The following code demonstrates how to do this for a Button.

    if (Microsoft.Services.Store.Engagement.StoreServicesFeedbackLauncher.IsSupported())
    {
        this.feedbackButton.Visibility = Visibility.Visible;
    }
    

    Примечание

    Хотя в настоящее время Центр отзывов не поддерживается на устройствах Xbox, свойство IsSupported возвращает значение true на устройствах Xbox под управлением Windows 10 версии 10.0.14271 или более поздней.Although Feedback Hub is not supported on Xbox devices at this time, the IsSupported property currently returns true on Xbox devices that run version 10.0.14271 or later of Windows 10. Это известная проблема, которая будет устранена в следующей версии пакета Microsoft Store Services SDK.This is a known issue that will be fixed in a future release of the Microsoft Store Services SDK.

  2. В обработчике событий, который запускается, когда пользователь щелкает элемент управления, получите объект StoreServicesFeedbackLauncher и вызовите метод LaunchAsync, чтобы открыть приложение Центр отзывов.In the event handler that runs when the user clicks the control, get a StoreServicesFeedbackLauncher object and call the LaunchAsync method to launch the Feedback Hub app. У этого метода есть две перегруженные версии: одна без параметров и другая версия, которая принимает словарь пар «ключ-значение», содержащий метаданные, которые нужно связать с отзывом.There are two overloads for this method: one without parameters, and another one that accepts a dictionary of key and value pairs that contain metadata that you want to associate with the feedback. В следующем примере показано, как запустить Центр отзывов в обработчике событий Click элемента управления Button.The following example demonstrates how to launch Feedback Hub in the Click event handler for a Button.

    private async void feedbackButton_Click(object sender, RoutedEventArgs e)
    {
        var launcher = Microsoft.Services.Store.Engagement.StoreServicesFeedbackLauncher.GetDefault();
        await launcher.LaunchAsync();
    }
    

Рекомендации по оформлению пользовательского интерфейса отзывовDesign recommendations for your feedback UI

Для запуска Центра отзывов мы рекомендуем добавить в приложение элемент пользовательского интерфейса (например, кнопку), который отображает следующий стандартный значок отзыва шрифта Segoe MDL2 Assets и символ с кодом E939.To launch Feedback Hub, we recommend that you add a UI element in your app (such as a button) that displays the following standard feedback icon from the Segoe MDL2 Assets font and the character code E939.

Мы также рекомендуем использовать один или несколько следующих вариантов размещения для привязки Центра отзывов в вашем приложении.We also recommend that you use one or more of the following placement options for linking to Feedback Hub in your app.

  • Непосредственно на панели приложения.Directly in the app bar. В зависимости от реализации вы можете использовать только значок или можете добавить текст (как показано ниже).Depending on your implementation, you may wish to use the icon only or add text (as shown below).

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

  • В параметрах приложения.In your app's settings. Это более тонкий способ предоставить доступ к Центру отзывов.This is a more subtle way to provide access to Feedback Hub. В примере ниже ссылка на отзыв отображается как одна из ссылок в приложении.In the example below, the Feedback link appears as one of the links under App.

    Снимок экрана со страницей параметров, где отображается ссылка на отзыв в разделе "приложение".

  • Во всплывающем элементе на основе событий.In an event-driven flyout. Это полезно, если вам требуется задать пользователям вопрос перед запуском Центра отзывов о Windows.This is useful when you want to query your customers about a specific question before launching into the Windows Feedback Hub. Например, после использования определенной функции в приложении вы можете задать вопрос о ней.For example, after your app uses a certain feature, you might prompt the customer with a specific question about their satisfaction with that feature. Если пользователь решает ответить на него, приложение запускает Центр отзывов.If the customer chooses to respond, your app launches Feedback Hub.