Use multimedia redirection on Azure Virtual Desktop (preview)

Important

Multimedia redirection on Azure Virtual Desktop is currently in preview. See the Supplemental Terms of Use for Microsoft Azure Previews for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.

This article will show you how to use multimedia redirection (MMR) for Azure Virtual Desktop (preview) with Microsoft Edge or Google Chrome browsers. For more information about how multimedia redirection works, see Understanding multimedia redirection for Azure Virtual Desktop.

Note

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

Multimedia redirection on Azure Virtual Desktop is only available for the Windows Desktop client on Windows 11, Windows 10, or Windows 10 IoT Enterprise devices. Multimedia redirection requires the Windows Desktop client, version 1.2.3573 or later. For more information, see Prerequisites.

Prerequisites

Before you can use multimedia redirection on Azure Virtual Desktop, you'll need the following things:

  • An Azure Virtual Desktop deployment.
  • 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. You can download the latest version from Microsoft Visual C++ Redistributable latest supported downloads.
  • Windows Desktop client, version 1.2.3573 or later on Windows 11, Windows 10, or Windows 10 IoT Enterprise devices. This includes the multimedia redirection plugin (C:\Program Files\Remote Desktop\MsMmrDVCPlugin.dll), which is required on the client device. Your device must meet the hardware requirements for Teams on a Windows PC.

Install the multimedia redirection extension

For multimedia redirection to work, there are two parts to install on your session hosts: the host component and the browser extension for Edge or Chrome. You install the host component and browser extension from an MSI file, and you can also get and install the browser extension from Microsoft Edge Add-ons or the Chrome Web Store, depending on which browser you're using.

Install the host component

To install the host component on your session hosts, you can install the MSI manually on each session host or use your enterprise deployment tool with msiexec. To install the MSI manually, you'll need to:

  1. Sign in to a session host as a local administrator.

  2. Download the MMR host MSI installer.

  3. Open the file that you downloaded to run the setup wizard.

  4. Follow the prompts. Once it's completed, select Finish.

Install the browser extension

Next, you'll need to install the browser extension. This is installed on session hosts where you already have Edge or Chrome available. Installing the host component also installs the browser extension. Users will see a prompt that says New Extension added. In order to use the app, they'll need to enable the extension. A user can enable the extension by doing the following:

  1. Sign in to Azure Virtual Desktop and open Edge or Chrome.

  2. At the prompt to enable the extension, select Turn on extension. Users should also pin the extension so that they can see from the icon if multimedia redirection is connected.

    A screenshot of the prompt to enable the extension.

    Important

    If the user selects Remove extension, it will be removed from the browser and they will need to add it from Microsoft Edge Add-ons or the Chrome Web Store. To install it again, see Installing the browser extension manually.

You can also automate installing the browser extension from Microsoft Edge Add-ons or the Chrome Web Store for all users by using Group Policy.

Using Group Policy has the following benefits:

  • You can install the extension silently and without user interaction.
  • You can restrict which websites use multimedia redirection.
  • You can pin the extension icon in Google Chrome by default.

Install the browser extension manually

If you need to install the browser extension separately, you can download it from Microsoft Edge Add-ons or the Chrome Web Store.

To install the multimedia redirection extension manually, follow these steps:

  1. Sign in to Azure Virtual Desktop.

  2. In your browser, open one of the following links, depending on which browser you're using:

  3. Install the extension by selecting Get (for Microsoft Edge) or Add to Chrome (for Google Chrome), then at the additional prompt, select Add extension. Once the installation is finished, you'll see a confirmation message saying that you've successfully added the extension.

Install the browser extension using Group Policy

You can install the multimedia redirection extension using Group Policy, either centrally from your domain for session hosts that are joined to an Active Directory (AD) domain, or using the Local Group Policy Editor for each session host. This process will change depending on which browser you're using.

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

  2. Next, decide whether you want to configure Group Policy centrally from your domain or locally for each session host:

    • To configure it from an AD Domain, open the Group Policy Management Console (GPMC) and create or edit a policy that targets your session hosts.

    • To configure it locally, open the Local Group Policy Editor on the session host.

  3. Go to Computer Configuration > Administrative Templates > Microsoft Edge > Extensions.

  4. Open the policy setting Configure extension management settings and set it to Enabled.

  5. In the field for Configure extension management settings, enter the following:

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

    You can specify additional parameters to allow or block specific domains. For example, to only allow youtube.com, enter the following:

    { "joeclbldhdmoijbaagobkhlpfjglcihd": { "installation_mode": "force_installed", "runtime_allowed_hosts": [ "*://*.youtube.com" ], "runtime_blocked_hosts": [ "*://*" ], "update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx" } }
    
  6. Apply the changes by running the following command in Command Prompt or PowerShell on each session host:

    gpupdate /force
    

Configure the Remote Desktop client

During the preview, you'll need to configure the Remote Desktop client to use Insider features. To learn more about the Insiders program, see Windows Desktop client for admins.

To enable Insider features:

  1. Add the following registry key and value:

    • Key: HKLM\Software\Microsoft\MSRDC\Policies
    • Type: REG_SZ
    • Name: ReleaseRing
    • Data: insider

    You can do configure the registry with PowerShell. On your local device, open an elevated PowerShell prompt and run the following commands:

    New-Item -Path "HKLM:\SOFTWARE\Microsoft\MSRDC\Policies" -Force
    New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\MSRDC\Policies" -Name ReleaseRing -PropertyType String -Value insider -Force
    
  2. Restart your local device.

  3. Open the Remote Desktop client. The title in the top left-hand corner should be Remote Desktop (Insider):

    A screenshot of the Remote Desktop client with Insider features enabled. The title is highlighted in a red box.

Check the extension status

You can check the extension status by visiting a website with media content, such as one from the list at Websites that work with multimedia redirection, and hovering your mouse cursor over the multimedia redirection extension icon in the extension bar on the top-right corner of your browser. A message will appear and tell you about the current status, as shown in the following screenshot.

A screenshot of the MMR extension in the Microsoft Edge extension bar.

Another way you can check the extension status is by selecting the extension icon, then you'll see a list of Features supported on this website with a green check mark if the website supports that feature.

Teams live events

To use multimedia redirection with Teams live events:

  1. Sign in to Azure Virtual Desktop.

  2. Open the link to the Teams live event in either the Edge or Chrome browser.

  3. Make sure you can see a green play icon as part of the multimedia redirection status icon. If the green play icon is there, MMR is enabled for Teams live events.

  4. Select Watch on the web instead. The Teams live event should automatically start playing in your browser. Make sure you only select Watch on the web instead, as shown in the following screenshot. If you use the native Teams app, MMR won't work.

    A screenshot of the 'Watch the live event in Microsoft Teams' page. The status icon and 'watch on the web instead' options are highlighted in red.

Enable video playback for all sites

During the preview, multimedia redirection is limited to the sites listed in Websites that work with multimedia redirection by default. However you can enable video playback for all sites to allow you to test the feature with other websites. To enable video playback for all sites:

  1. Select the extension icon in your browser.

  2. Select Show Advanced Settings.

  3. Toggle Enable video playback for all sites(beta) to on.

Redirected video outlines

Redirected video outlines will allow you to highlight the currently redirected video elements. When this is enabled, you will see a bright highlighted boarder around the video element that is being redirected. To enable redirected video outlines:

  1. Select the extension icon in your browser.

  2. Select Show Advanced Settings.

  3. Toggle Redirected video outlines to on. You will need to refresh the webpage for the change to take effect.

Next steps

For more information about multimedia redirection and how it works, see What is multimedia redirection for Azure Virtual Desktop? (preview).

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

If you're interested in learning more about using Teams for Azure Virtual Desktop, check out Teams for Azure Virtual Desktop.