你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Multimedia redirection for video playback and calls in a remote session

Tip

This article is shared for services and products that use the Remote Desktop Protocol (RDP) to provide remote access to Windows desktops and apps.

Select a product using the buttons at the top of this article to show the relevant content.

Multimedia redirection redirects video playback and calls in a remote session from Azure Virtual Desktop, a Windows 365 Cloud PC, or Microsoft Dev Box to your local device for faster processing and rendering. Specifically, these two functions work in the following ways:

• Video playback redirection: optimizes video playback experience for web pages with embedded videos like YouTube and Facebook. The browser in the remote session fetches video content, but the bitstream of video data is sent to the local device where it decodes and renders the video in the correct place on the screen.

  

• Call redirection: optimizes audio calls for WebRTC-based calling apps, reducing latency, and improving call quality. The connection happens between the local device and the telephony app server, where WebRTC calls are offloaded from a remote session to a local device, as shown in the following diagram. However, after the connection is established, call quality becomes dependent on the web page or app providers, just as it would with a non-redirected call.

  

There are two components you need to install for multimedia redirection:

• Remote Desktop Multimedia Redirection Service
• Browser extension for Microsoft Edge or Google Chrome browsers

This article shows you install and configure multimedia redirection in a remote session from Azure Virtual Desktop, a Windows 365 Cloud PC, or Microsoft Dev Box with Microsoft Edge or Google Chrome browsers, and manage settings for the browser extension using Microsoft Intune or Group Policy. Additionally, this article shows you how to manage settings for the browser extension in Microsoft Edge using the Microsoft Edge management service.

Later in the article you can find a list of websites that work with multimedia redirection for video playback and calls.

Prerequisites

Before you can use multimedia redirection, you need:

• An existing host pool with session hosts.

• Local administrator privilege on your session hosts to install and update the Remote Desktop Multimedia Redirection Service.

• The latest version of Microsoft Edge or Google Chrome installed on your session hosts.

• Microsoft Visual C++ Redistributable 2015-2022, version 14.32.31332.0 or later installed on your session hosts and local Windows devices. You can download the latest version from Microsoft Visual C++ Redistributable latest supported downloads.

• An existing Cloud PC.

• Local administrator privilege on your Cloud PC to install and update the Remote Desktop Multimedia Redirection Service.

• The latest version of Microsoft Edge or Google Chrome installed on your Cloud PC.

• Microsoft Visual C++ Redistributable 2015-2022, version 14.32.31332.0 or later installed on your Cloud PC and local Windows devices. You can download the latest version from Microsoft Visual C++ Redistributable latest supported downloads.

• An existing dev box.

• Local administrator privilege on your dev box to install and update the Remote Desktop Multimedia Redirection Service.

• The latest version of Microsoft Edge or Google Chrome installed on your dev box.

• Microsoft Visual C++ Redistributable 2015-2022, version 14.32.31332.0 or later installed on your dev box and local Windows devices. You can download the latest version from Microsoft Visual C++ Redistributable latest supported downloads.

• To configure multimedia redirection using Microsoft Intune, you need:

  • Microsoft Entra ID account that is assigned the Policy and Profile manager built-in RBAC role.
  • A group containing the devices you want to configure.

• To configure multimedia redirection using Group Policy, you need:

  • A domain account that has permission to create or edit Group Policy objects.
  • A security group or organizational unit (OU) containing the devices you want to configure.

• You need to connect to a remote session from one of the following supported apps and platforms:

  • Windows App on Windows, version 2.0.297.0 or later.
  • Remote Desktop app on Windows, version 1.2.5709 or later.

• Your local Windows device must meet the hardware requirements for Teams on a Windows PC.

Note

Multimedia redirection isn't supported on Azure Virtual Desktop for Azure US Government, or Windows 365 for Microsoft 365 Government (GCC), GCC-High environments, and Microsoft 365 DoD.

Install multimedia redirection on session hosts

There are two components you need to install on your session hosts:

Install multimedia redirection on a Cloud PC

Important

Multimedia redirection is already installed on Microsoft gallery images for Windows 365. You only need to install multimedia redirection on your Cloud PC if you're using a custom image.

There are two components you need to install on your Cloud PC:

Install multimedia redirection on a dev box

There are two components you need to install on your dev box:

• Remote Desktop Multimedia Redirection Service
• Browser extension for Microsoft Edge or Google Chrome browsers

You install both the multimedia redirection service and browser extension from a single .msi file, which you can run manually, use Intune Win32 app management, or your enterprise deployment tool with msiexec. To install the .msi file:

1. Download the multimedia redirection installer.

2. Make sure Microsoft Edge or Google Chrome isn't running. Check in Task Manager that there are no instances of msedge.exe or chrome.exe listed in the Details tab.

3. Install the .msi file using one of the following methods:

   • To install it manually, open the file that you downloaded to run the setup wizard, then follow the prompts. After it's installed, select Finish.

   • Alternatively, use the following command with Intune or your enterprise deployment tool as an administrator from Command Prompt. This example specifies there's no UI or user interaction required during the installation process.

     msiexec /i <path to the MSI file> /qn
     

After you install the multimedia redirection service and browser extension, next you need to enable the browser extension.

Important

The Remote Desktop Multimedia Redirection Service doesn't update automatically. You need to update the service manually when a new version is available. You can download the latest version from the same URL in this section and install using the same steps, which automatically replaces the previous version. For information about the latest version, see What's new in multimedia redirection.

The browser extension updates automatically when a new version is available.

Enable the browser extension

By default, users are automatically prompted to enable the extension when they open their browser. You can also enable and manage the browser extension from Microsoft Edge Add-ons or the Chrome Web Store for all users by using Microsoft Intune or Group Policy, or the Microsoft Edge management service (for Microsoft Edge only).

Managing the browser extension has the following benefits:

• Enable the browser extension silently and without user interaction.
• Restrict which web pages use multimedia redirection.
• Show or hide advanced settings for the browser extension.
• Pin the browser extension to the browser toolbar.

Select the relevant tab for your scenario.

For Windows 365, we recommend using Microsoft Intune to enable the multimedia redirection browser extension.

Microsoft Intune

To enable the multimedia redirection browser extension using Microsoft Intune, expand one of the following sections, depending on which browser you're using:

For Microsoft Edge, expand this section.

1. Sign in to the Microsoft Intune admin center.

2. Create or edit a configuration profile for Windows 10 and later devices, with the Settings catalog profile type.

3. In the settings picker, browse to Microsoft Edge > Extensions.

   

4. Check the box for Configure extension management settings, then close the settings picker.

5. Expand the Microsoft Edge category, then toggle the switch for Configure extension management settings to Enabled

   

6. In the box that appears for Configure extension management settings (Device), enter the following JSON as a single line string. This example installs the extension with the required update URL:

   {
     "joeclbldhdmoijbaagobkhlpfjglcihd": {
       "installation_mode": "force_installed",
       "update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx",
     }
   }
   

   Note

   You can specify additional parameters to allow or block specific sites for redirection and to show or hide advanced settings. For more information, see:

   • Common policy configuration parameters.
   • Allow or block video playback redirection for specific domains.
   • Enable call redirection for specific domains.

7. Select Next.

8. Optional: On the Scope tags tab, select a scope tag to filter the profile. For more information about scope tags, see Use role-based access control (RBAC) and scope tags for distributed IT.

9. On the Assignments tab, select the group containing the computers providing a remote session you want to configure, then select Next.

10. On the Review + create tab, review the settings, then select Create.

11. After the policy applies to the computers providing a remote session, restart them for the settings to take effect.

For Google Chrome, expand this section.

1. Download the administrative template for Google Chrome. Select the option Chrome ADM/ADMX templates to download the ZIP file.

2. Sign in to the Microsoft Intune admin center.

3. Follow the steps to Import custom ADMX and ADML administrative templates into Microsoft Intune. You need to import the google.admx and google.adml first, then import chrome.admx and chrome.adml.

4. After you imported the Google Chrome administrative template, follow the steps to Create a profile using your imported files

5. In configuration settings, browse to Computer Configuration > Google > Google Chrome > Extensions.

   

6. Select Extension management settings, which opens a new pane. Scroll to the end, then select Enabled.

   

7. In the box, enter the following JSON as a single line string. This example installs the extension with the required update URL:

   {
     "lfmemoeeciijgkjkgbgikoonlkabmlno": {
       "installation_mode": "force_installed",
       "update_url": "https://clients2.google.com/service/update2/crx",
     }
   }
   

   Note

   You can specify additional parameters to allow or block specific sites for redirection and to show or hide advanced settings. For more information, see:

   • Common policy configuration parameters.
   • Allow or block video playback redirection for specific domains.
   • Enable call redirection for specific domains.

8. Select OK, then select Next.

9. Optional: On the Scope tags tab, select a scope tag to filter the profile. For more information about scope tags, see Use role-based access control (RBAC) and scope tags for distributed IT.

10. On the Assignments tab, select the group containing the computers providing a remote session you want to configure, then select Next.

11. On the Review + create tab, review the settings, then select Create.

12. After the policy applies to the computers providing a remote session, restart them for the settings to take effect.

Group Policy

To enable the multimedia redirection browser extension using Group Policy:

For Microsoft Edge, expand this section.

1. Download and install the Microsoft Edge administrative template by following the directions in Configure Microsoft Edge policy settings on Windows devices.

2. Open the Group Policy Management console on device you use to manage the Active Directory domain.

3. Create or edit a policy that targets the computers providing a remote session you want to configure.

4. Navigate to Computer Configuration > Policies > Administrative Templates > Microsoft Edge > Extensions.

   

5. Double-click the policy setting Configure extension management settings to open it.

   

6. Select Enabled, then in the field for Configure extension management settings, enter the following JSON as a single line string. This example installs the extension with the required update URL:

   {
     "joeclbldhdmoijbaagobkhlpfjglcihd": {
       "installation_mode": "force_installed",
       "update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx",
     }
   }
   

   Note

   You can specify additional parameters to allow or block specific sites for redirection and to show or hide advanced settings. For more information, see:

   • Common policy configuration parameters.
   • Allow or block video playback redirection for specific domains.
   • Enable call redirection for specific domains.

7. Ensure the policy is applied to the computers providing a remote session, then restart them for the settings to take effect.

For Google Chrome, expand this section.

1. Download the administrative template for Google Chrome. Select the option Chrome ADM/ADMX templates to download the ZIP file.

2. On your domain controllers, copy and paste the following files to the relevant location, depending if you store Group Policy templates in the local PolicyDefinitions folder or the Group Policy Central Store. Replace contoso.com with your domain name, and en-US if you're using a different language.

   • Filename: terminalserver-avd.admx

     • Local location: C:\Windows\PolicyDefinitions\
     • Central Store: \\contoso.com\SYSVOL\contoso.com\Policies\PolicyDefinitions

   • Filename: en-US\terminalserver-avd.adml

     • Local location: C:\Windows\PolicyDefinitions\en-US\
     • Central Store: \\contoso.com\SYSVOL\contoso.com\Policies\PolicyDefinitions\en-US

3. Open the Group Policy Management console on device you use to manage the Active Directory domain.

4. Create or edit a policy that targets the computers providing a remote session you want to configure.

5. Navigate to Computer Configuration > Policies > Administrative Templates > Google > Google Chrome > Extensions.

   

6. Double-click the policy setting Extension management settings to open it.

   

7. Select Enabled, then in the field for Extension management settings, enter the following JSON as a single line string. This example installs the extension with the required update URL:

   {
     "lfmemoeeciijgkjkgbgikoonlkabmlno": {
       "installation_mode": "force_installed",
       "update_url": "https://clients2.google.com/service/update2/crx",
     }
   }
   

   Note

   You can specify additional parameters to allow or block specific sites for redirection and to show or hide advanced settings. For more information, see:

   • Common policy configuration parameters.
   • Allow or block video playback redirection for specific domains.
   • Enable call redirection for specific domains.

8. Ensure the policy is applied to the computers providing a remote session, then restart them for the settings to take effect.

Microsoft Edge management service

To enable the multimedia redirection browser extension using the Microsoft Edge management service:

1. Sign in to the Microsoft 365 admin center.

2. Create a configuration profile for Microsoft Edge.

3. After the profile is created, select it, then select Extensions.

   

4. Select + Select extension.

5. In the new pane that opens, enter extension ID joeclbldhdmoijbaagobkhlpfjglcihd into the search box. The Microsoft Multimedia Redirection extension appears in the search results. Select Select and close the pane. You can't search for it by name.

   

6. Select the Microsoft Multimedia Redirection extension display name, which opens a new pane. From this pane you can configure the extension settings, based on your requirements. You can also use any of the JSON examples for Microsoft Edge in this article to add the extension or modify its settings.

   

7. Follow the steps to Assign a configuration profile to a Microsoft Entra group, then Configure Microsoft Edge to use a configuration profile to apply the profile to the groups of users you specify.

Common policy configuration parameters

The following sections show some examples of policy configuration parameters for the browser you can use to manage the multimedia redirection browser extension that are common for both video playback and call redirection. You can use these examples as part of the steps in Enable the browser extension. Combine these examples with the parameters you require for your users.

Note

The following examples are for Microsoft Edge. For Google Chrome:

• Change joeclbldhdmoijbaagobkhlpfjglcihd to lfmemoeeciijgkjkgbgikoonlkabmlno.
• Change the update_url to https://clients2.google.com/service/update2/crx.

Show or hide the extension on the browser toolbar

You can show or hide the extension icon on the browser toolbar. By default, extension icons are hidden from the toolbar.

The following example installs the extension and shows the extension icon on the toolbar by default, but still allows users to hide it. Other values are force_shown and default_hidden. For more information about configuring extensions for Microsoft Edge, see A detailed guide to configuring extensions using the ExtensionSettings policy.

{
  "joeclbldhdmoijbaagobkhlpfjglcihd": {
    "installation_mode": "force_installed",
    "update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx",
    "toolbar_state": "default_shown"
  }
}

Show or hide advanced settings button

You can show or hide the advanced settings button to users in the extension. By default, the advanced settings button is shown and users have access to toggle each setting on or off. If you hide the advanced settings button, users can still collect logs.

Here's what the extension looks like when the advanced settings button is hidden:

This example installs the extension and hides the advanced settings button. Alternatively, to show the advanced settings button, set HideAdvancedSettings to false.

{
  "joeclbldhdmoijbaagobkhlpfjglcihd": {
    "installation_mode": "force_installed",
    "update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx",
    "HideAdvancedSettings": true
  }
}

Browser extension status

The extension icon changes based on whether multimedia redirection is available on the current web page and which features are supported. The following table shows the different states of the extension icon and their definitions:

Icon State	Definition
	The multimedia redirection extension is loaded, indicating that the website can be redirected.
	The multimedia redirection extension isn't loaded, indicating that content on the web page isn't redirected.
	The multimedia redirection extension is currently redirecting video playback.
	The multimedia redirection extension is currently redirecting a call.
	The multimedia redirection extension failed to load correctly. You might need to uninstall and reinstall the extension or the Remote Desktop Multimedia Redirection Service, then try again.

Video playback redirection

The following sections contain information about how to test video playback redirection and how you can configure advanced settings.

Websites for video playback redirection

The following websites are known to work with video playback redirection, and which work by default.

• AWS Training
• BBC
• Big Think
• CNBC
• Coursera
• Daily Mail
• Facebook
• Fidelity
• Fox Sports

• Fox Weather
• IMDB
• Infosec Institute
• LinkedIn Learning
• Microsoft Learn
• Microsoft Stream
• Microsoft Teams live events
• Pluralsight
• Skillshare

• The Guardian
• Twitch
• Udemy*
• UMU
• U.S. News
• Vimeo
• Yahoo
• Yammer
• YouTube (including sites with embedded YouTube videos).

Important

Video playback redirection doesn't support protected content. Protected content can be played without multimedia redirection using regular video playback.

Test video playback redirection

After you enable multimedia redirection, you can test it by visiting a web page with video playback from the list in Websites for video playback redirection and following these steps:

1. Open the web page in Microsoft Edge or Google Chrome on your remote session.

2. Select the Microsoft Multimedia Redirection extension icon in the extension bar on the top-right corner of your browser. If you're on a web page where multimedia redirection is available, the icon has a blue border (rather than grey), and shows the message The extension is loaded. For web pages that support video playback redirection, Video Playback Redirection has a green check mark.

   

3. On the web page, play a video. Check the status of the extension icon that multimedia redirection is active in your browser, which should look like the following image:

   

Microsoft Teams live events

Microsoft Teams live events aren't media-optimized when using the native Teams app in a remote session. However, if you use Teams live events with a browser that supports Teams live events and multimedia redirection, multimedia redirection is a workaround that provides smoother Teams live events playback in a remote session. Multimedia redirection supports Enterprise Content Delivery Network (ECDN) for Teams live events.

To use multimedia redirection with Teams live events, you must use the web version of Teams. Multimedia redirection isn't supported with the native Teams app. When you launch the live event in your browser, make sure you select Watch on the web instead. The Teams live event should automatically start playing in your browser with multimedia redirection enabled.

Advanced settings for video playback redirection

The following advanced settings are available for video playback redirection. You can also hide the advanced settings button from users; for more information, see Show or hide advanced settings button.

• Enable video playback for all sites (beta): By default, video playback redirection is limited to the sites listed in Websites for video playback redirection. You can enable video playback redirection for all sites to test the feature with other web pages. This setting is experimental and might not work as expected.

• Video status overlay: When enabled, a short message appears at the top of the video player that indicates the redirection status of the current video. The message disappears after five seconds.

• Enable redirected video playback overlay: When enabled, a bright highlighted border appears around the video playback element that is being redirected.

To enable these advanced settings:

1. Select the extension icon in your browser.

2. Select Show Advanced Settings.

3. Toggle the settings you want to enable to on.

Allow or block video playback redirection for specific domains

If you configure multimedia redirection using Microsoft Intune or Group Policy, you can allow or block specific domains for video playback redirection.

Note

The following example is for Microsoft Edge. For Google Chrome:

• Change joeclbldhdmoijbaagobkhlpfjglcihd to lfmemoeeciijgkjkgbgikoonlkabmlno.
• Change the update_url to https://clients2.google.com/service/update2/crx.

This example installs the extension and allows learn.microsoft.com and youtube.com, but blocks all other domains. You can use this example as part of the steps in Enable the browser extension.

{
  "joeclbldhdmoijbaagobkhlpfjglcihd": {
    "installation_mode": "force_installed",
    "runtime_allowed_hosts": [ "*://*.learn.microsoft.com";"*://*.youtube.com" ],
    "runtime_blocked_hosts": [ "*://*" ],
    "update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx",
    "toolbar_state": "default_shown"
  }
}

Call redirection

The following sections contain information about how to test call redirection and how you can configure advanced settings.

Websites for call redirection

The following websites are known to work with call redirection, and which work by default.

• WebRTC Sample Site
• Content Guru Storm App
• Twilio Flex

Test call redirection

After you enable multimedia redirection, you can test it by visiting a web page with calling from the list in Websites for call redirection and following these steps:

1. Open the web page in Microsoft Edge or Google Chrome on your remote session.

2. Select the Microsoft Multimedia Redirection extension icon in the extension bar on the top-right corner of your browser. If you're on a web page where multimedia redirection is available, the icon has a blue border (rather than grey), and shows the message The extension is loaded. For web pages that support call redirection, Call Redirection has a green check mark.

   

3. On the web page, make a call. Check the status of the extension icon that multimedia redirection is active in your browser, which should look like the following image:

   

Enable call redirection for specific domains

If you configure multimedia redirection using Microsoft Intune or Group Policy, you can enable one or more domains for call redirection. This parameter enables you to specify extra sites in addition to the Websites for call redirection. The supported format is the fully qualified domain name (FQDN) with up to one subdirectory. The following formats are supported:

• contoso.com
• conferencing.contoso.com
• contoso.com/conferencing

The following formats aren't supported:

• www.contoso.com
• contoso.com/conferencing/groups
• contoso.com/

Note

The following example is for Microsoft Edge. For Google Chrome:

• Change joeclbldhdmoijbaagobkhlpfjglcihd to lfmemoeeciijgkjkgbgikoonlkabmlno.
• Change the update_url to https://clients2.google.com/service/update2/crx.

This example installs the extension and adds calling sites contoso.com, conferencing.contoso.com, and contoso.com/conferencing, which are separated by a semicolon ;:

{
  "joeclbldhdmoijbaagobkhlpfjglcihd": {
    "installation_mode": "force_installed",
    "AllowedCallRedirectionSites": "contoso.com;conferencing.contoso.com;contoso.com/conferencing",
    "update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx",
    "toolbar_state": "default_shown"
  }
}

Enable call redirection for all sites for testing

You can enable call redirection for all sites to allow you to test web pages that aren't listed in Websites for call redirection. This setting is experimental and can be useful when developing integration of your website with call redirection.

To enable call redirection for all sites:

1. On a local Windows device, add the following registry key and value:

   • Key: HKEY_CURRENT_USER\Software\Microsoft\MMR
   • Type: REG_DWORD
   • Value: AllowCallRedirectionAllSites
   • Data: 1

2. Connect to a remote session and load a web browser, then select the extension icon in your browser.

3. Select Show Advanced Settings.

4. Toggle Enable call redirection for all sites (experimental) to on.

   

Next step

To troubleshoot issues or view known issues, see our troubleshooting article.