Interfaces for "Enhanced UX Notification for Video and Audio Call Feature"

dev/AppNotifications/AppNotification.cpp

@@ -119,4 +119,16 @@ namespace winrt::Microsoft::Windows::AppNotifications::implementation
         auto lock{ m_lock.lock_exclusive() };
         m_notificationId = id;
     }
+
+    winrt::Microsoft::Windows::AppNotifications::AppNotificationDevicesData AppNotification::DevicesData()
+    {
+        auto lock{ m_lock.lock_shared() };
+        return m_devicesData;
+    }
+
+    void AppNotification::DevicesData(winrt::Microsoft::Windows::AppNotifications::AppNotificationDevicesData const& devicesData)
+    {
+        auto lock{ m_lock.lock_exclusive() };
+        m_devicesData = devicesData;
+    }
 }

dev/AppNotifications/AppNotification.h

@@ -37,6 +37,9 @@ namespace winrt::Microsoft::Windows::AppNotifications::implementation
         // IAppNotificationInternal
         void SetNotificationId(uint32_t id);
 
+        winrt::Microsoft::Windows::AppNotifications::AppNotificationDevicesData DevicesData();
+        void DevicesData(winrt::Microsoft::Windows::AppNotifications::AppNotificationDevicesData const& value);
+
     private:
         winrt::hstring m_tag{};
         winrt::hstring m_group{};
@@ -49,6 +52,8 @@ namespace winrt::Microsoft::Windows::AppNotifications::implementation
         { winrt::Microsoft::Windows::AppNotifications::AppNotificationPriority::Default };
         bool m_suppressDisplay{ false };
         wil::srwlock m_lock;
+
+        winrt::Microsoft::Windows::AppNotifications::AppNotificationDevicesData m_devicesData{ nullptr };
     };
 }
 namespace winrt::Microsoft::Windows::AppNotifications::factory_implementation

dev/AppNotifications/AppNotificationBuilder/AppNotificationBuilder.cpp

@@ -1,4 +1,4 @@
-// Copyright (c) Microsoft Corporation and Contributors.
+// Copyright (c) Microsoft Corporation and Contributors.
 // Licensed under the MIT License.
 
 #include "pch.h"
@@ -376,14 +376,15 @@ namespace winrt::Microsoft::Windows::AppNotifications::Builder::implementation
         // Build the actions string and fill m_useButtonStyle
         std::wstring actions{ GetActions() };
 
-        auto xmlResult{ wil::str_printf<std::wstring>(L"<toast%ls%ls%ls%ls%ls><visual><binding template='ToastGeneric'>%ls%ls%ls%ls</binding></visual>%ls%ls</toast>",
+        auto xmlResult{ wil::str_printf<std::wstring>(L"<toast%ls%ls%ls%ls%ls><visual><binding template='ToastGeneric'>%ls%ls%ls%ls%ls</binding></visual>%ls%ls</toast>",
             m_timeStamp.c_str(),
             GetDuration().c_str(),
             GetScenario().c_str(),
             GetArguments().c_str(),
             GetButtonStyle().c_str(),
             GetText().c_str(),
             m_attributionText.c_str(),
+            GetCameraPreview().c_str(),
             GetImages().c_str(),
             GetProgressBars().c_str(),
             m_audio.c_str(),
@@ -399,4 +400,17 @@ namespace winrt::Microsoft::Windows::AppNotifications::Builder::implementation
 
         return appNotification;
     }
+
+    winrt::Microsoft::Windows::AppNotifications::Builder::AppNotificationBuilder AppNotificationBuilder::AddCameraPreview()
+    {
+        THROW_HR_IF_MSG(E_INVALIDARG, m_useCameraPreview, "CameraPreview element is already added, only one is allowed");
+
+        m_useCameraPreview = true;
+        return *this;
+    }
+
+    std::wstring AppNotificationBuilder::GetCameraPreview()
+    {
+        return m_useCameraPreview ? L"<cameraPreview/>" : L"";
+    }
 }

dev/AppNotifications/AppNotificationBuilder/AppNotificationBuilder.h

@@ -1,4 +1,4 @@
-// Copyright (c) Microsoft Corporation. All rights reserved.
+// Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License. See LICENSE in the project root for license information.
 
 #pragma once
@@ -65,6 +65,8 @@ namespace winrt::Microsoft::Windows::AppNotifications::Builder::implementation
 
         static bool IsUrgentScenarioSupported();
 
+        winrt::Microsoft::Windows::AppNotifications::Builder::AppNotificationBuilder AddCameraPreview();
+
     private:
         void ThrowIfMaxInputItemsExceeded();
         std::wstring GetDuration();
@@ -75,6 +77,7 @@ namespace winrt::Microsoft::Windows::AppNotifications::Builder::implementation
         std::wstring GetImages();
         std::wstring GetActions();
         std::wstring GetProgressBars();
+        std::wstring GetCameraPreview();
 
         std::wstring m_timeStamp{};
         AppNotificationDuration m_duration{ AppNotificationDuration::Default };
@@ -93,6 +96,7 @@ namespace winrt::Microsoft::Windows::AppNotifications::Builder::implementation
         std::vector<AppNotificationComboBox> m_comboBoxList{};
         winrt::hstring m_tag{};
         winrt::hstring m_group{};
+        bool m_useCameraPreview{false};
     };
 }
 namespace winrt::Microsoft::Windows::AppNotifications::Builder::factory_implementation

dev/AppNotifications/AppNotificationBuilder/AppNotificationBuilder.idl

@@ -1,11 +1,11 @@
-// Copyright (c) Microsoft Corporation. All rights reserved.
+// Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License. See LICENSE in the project root for license information.
 
 import "..\AppNotifications\AppNotifications.idl";
 
 namespace Microsoft.Windows.AppNotifications.Builder
 {
-    [contractversion(1)]
+    [contractversion(2)]
     apicontract AppNotificationBuilderContract {}
 
     [contract(AppNotificationBuilderContract, 1)]
@@ -31,6 +31,14 @@ namespace Microsoft.Windows.AppNotifications.Builder
         Critical,
     };
 
+    [contract(AppNotificationBuilderContract, 2)]
+    enum AppNotificationButtonSettingType
+    {
+        none,
+        VideoCall,
+        AudioCall,
+    };
+
     [contract(AppNotificationBuilderContract, 1)]
     runtimeclass AppNotificationButton
     {
@@ -69,6 +77,10 @@ namespace Microsoft.Windows.AppNotifications.Builder
         // Launches the URI passed into the button when activated.
         AppNotificationButton SetInvokeUri(Windows.Foundation.Uri protocolUri);
         AppNotificationButton SetInvokeUri(Windows.Foundation.Uri protocolUri, String targetAppId);
+
+        // Sets the setting type for the button.
+        [contract(AppNotificationBuilderContract, 2)]
+        AppNotificationButton SetSettingType(AppNotificationButtonSettingType value);
     };
 
     [contract(AppNotificationBuilderContract, 1)]
@@ -242,5 +254,9 @@ namespace Microsoft.Windows.AppNotifications.Builder
         // AppNotification properties
         AppNotificationBuilder SetTag(String value);
         AppNotificationBuilder SetGroup(String group);
+
+        // Adds a camera preview to the AppNotification
+        [contract(AppNotificationBuilderContract, 2)]
+        AppNotificationBuilder AddCameraPreview();
     };
 }

dev/AppNotifications/AppNotificationBuilder/AppNotificationButton.cpp

@@ -1,4 +1,4 @@
-// Copyright (c) Microsoft Corporation and Contributors.
+// Copyright (c) Microsoft Corporation and Contributors.
 // Licensed under the MIT License.
 
 #include "pch.h"
@@ -121,17 +121,42 @@ namespace winrt::Microsoft::Windows::AppNotifications::Builder::implementation
     {
         auto logTelemetry{ AppNotificationBuilderTelemetry::ButtonToString::Start(g_telemetryHelper) };
 
-        std::wstring xmlResult{ wil::str_printf<std::wstring>(L"<action content='%ls'%ls%ls%ls%ls%ls%ls/>",
+        std::wstring xmlResult{ wil::str_printf<std::wstring>(L"<action content='%ls'%ls%ls%ls%ls%ls%ls%ls/>",
             m_content.c_str(),
             GetActivationArguments().c_str(),
             m_useContextMenuPlacement ? L" placement='contextMenu'" : L"",
             m_iconUri ? wil::str_printf<std::wstring>(L" imageUri='%ls'", m_iconUri.ToString().c_str()).c_str() : L"",
             !m_inputId.empty() ? wil::str_printf<std::wstring>(L" hint-inputId='%ls'", m_inputId.c_str()).c_str() : L"",
             GetButtonStyle().c_str(),
-            !m_toolTip.empty() ? wil::str_printf<std::wstring>(L" hint-toolTip='%ls'", m_toolTip.c_str()).c_str() : L"") };
+            !m_toolTip.empty() ? wil::str_printf<std::wstring>(L" hint-toolTip='%ls'", m_toolTip.c_str()).c_str() : L"",
+            GetSettingType().c_str()) };
 
         logTelemetry.Stop();
 
         return xmlResult.c_str();
     }
+
+    winrt::Microsoft::Windows::AppNotifications::Builder::AppNotificationButton AppNotificationButton::SetSettingType(AppNotificationButtonSettingType const& value)
+    {
+        m_settingType = value;
+        return *this;
+    }
+
+    std::wstring AppNotificationButton::GetSettingType()
+    {
+        if (m_settingType == AppNotificationButtonSettingType::none)
+        {
+            return L""; 
+        }
+
+        switch (m_settingType)
+        {
+        case AppNotificationButtonSettingType::VideoCall:
+            return L" settingType='VideoDevices'";
+        case AppNotificationButtonSettingType::AudioCall:
+            return L" settingType='AudioDevices'";
+        default:
+            return L"";
+        }
+    }
 }

dev/AppNotifications/AppNotificationBuilder/AppNotificationButton.h

@@ -1,4 +1,4 @@
-// Copyright (c) Microsoft Corporation and Contributors.
+// Copyright (c) Microsoft Corporation and Contributors.
 // Licensed under the MIT License.
 
 #pragma once
@@ -60,9 +60,12 @@ namespace winrt::Microsoft::Windows::AppNotifications::Builder::implementation
 
         winrt::hstring ToString();
 
+        winrt::Microsoft::Windows::AppNotifications::Builder::AppNotificationButton SetSettingType(AppNotificationButtonSettingType const& value);
+
     private:
         std::wstring GetActivationArguments();
         std::wstring GetButtonStyle();
+        std::wstring GetSettingType();
 
         winrt::hstring m_content{};
         winrt::Windows::Foundation::Collections::IMap<winrt::hstring, winrt::hstring> m_arguments { winrt::single_threaded_map<winrt::hstring, winrt::hstring>() };
@@ -73,6 +76,7 @@ namespace winrt::Microsoft::Windows::AppNotifications::Builder::implementation
         winrt::hstring m_inputId{};
         bool m_useContextMenuPlacement{};
         AppNotificationButtonStyle m_buttonStyle { AppNotificationButtonStyle::Default };
+        AppNotificationButtonSettingType m_settingType{ AppNotificationButtonSettingType::none };
     };
 }
 namespace winrt::Microsoft::Windows::AppNotifications::Builder::factory_implementation

dev/AppNotifications/AppNotificationDevicesData.cpp

@@ -0,0 +1,46 @@
+#include "pch.h"
+#include "AppNotificationDevicesData.h"
+#include "Microsoft.Windows.AppNotifications.AppNotificationDevicesData.g.cpp"
+#include <IsWindowsVersion.h>
+
+namespace winrt::Microsoft::Windows::AppNotifications::implementation
+{
+    hstring AppNotificationDevicesData::CameraDeviceId()
+    {
+        return m_cameraDeviceId;
+    }
+
+    void AppNotificationDevicesData::CameraDeviceId(hstring const& value)
+    {
+        m_cameraDeviceId = value;
+    }
+
+    hstring AppNotificationDevicesData::MicrophoneDeviceId()
+    {
+        return m_microphoneDeviceId;
+    }
+
+    void AppNotificationDevicesData::MicrophoneDeviceId(hstring const& value)
+    {
+        m_microphoneDeviceId = value;
+    }
+
+    hstring AppNotificationDevicesData::SpeakerDeviceId()
+    {
+        return m_speakerDeviceId;
+    }
+
+    void AppNotificationDevicesData::SpeakerDeviceId(hstring const& value)
+    {
+        m_speakerDeviceId = value;
+    }
+
+    /// <summary>
+    /// verifies if video calling is supported <TO DO>
+    /// </summary>
+    /// <returns>bool</returns>
+    bool AppNotificationDevicesData::IsVideoOrAudioCallingSupported()
+    {
+        return WindowsVersion::IsWindows11_23H1OrGreater(); // Windows 11 23H1 or greater
+    }
+}

dev/AppNotifications/AppNotificationDevicesData.h

@@ -0,0 +1,34 @@
+#pragma once
+#include "Microsoft.Windows.AppNotifications.AppNotificationDevicesData.g.h"
+
+namespace winrt::Microsoft::Windows::AppNotifications::implementation
+{
+    struct AppNotificationDevicesData : AppNotificationDevicesDataT<AppNotificationDevicesData>
+    {
+        AppNotificationDevicesData() = default;
+
+        // Getters
+        hstring CameraDeviceId();
+        hstring MicrophoneDeviceId();
+        hstring SpeakerDeviceId();
+
+        // Setters
+        void CameraDeviceId(hstring const& value);
+        void MicrophoneDeviceId(hstring const& value);
+        void SpeakerDeviceId(hstring const& value);
+
+        static bool IsVideoOrAudioCallingSupported();
+
+    private:
+
+        hstring m_cameraDeviceId{};
+        hstring m_microphoneDeviceId{};
+        hstring m_speakerDeviceId{};
+    };
+}
+namespace winrt::Microsoft::Windows::AppNotifications::factory_implementation
+{
+    struct AppNotificationDevicesData : AppNotificationDevicesDataT<AppNotificationDevicesData, implementation::AppNotificationDevicesData>
+    {
+    };
+}

dev/AppNotifications/AppNotifications.idl

@@ -1,4 +1,4 @@
-// Copyright (c) Microsoft Corporation and Contributors.
+// Copyright (c) Microsoft Corporation and Contributors.
 // Licensed under the MIT License.
 import "..\AppLifecycle\AppLifecycle.idl";
 
@@ -111,6 +111,30 @@ namespace Microsoft.Windows.AppNotifications
 
         // Gets or sets whether a Notification's pop-up UI is displayed on the user's screen.
         Boolean SuppressDisplay;
+
+        // Gets or sets the Notification Device Data
+        [contract(AppNotificationsContract, 2)]
+        AppNotificationDevicesData DevicesData;
+    }
+
+    // The Notification Device Data
+    [contract(AppNotificationsContract, 2)]
+    runtimeclass AppNotificationDevicesData
+    {
+        // Initializes a new Instance of NotificationDevicesData
+        AppNotificationDevicesData();
+
+        // Checks if Video or Audio Calling is supported
+        static Boolean IsVideoOrAudioCallingSupported();
+
+        // Gets or sets the Camera Device Id
+        String CameraDeviceId{ get; set; };
+
+        // Gets or sets the Microphone Device Id
+        String MicrophoneDeviceId{ get; set; };
+
+        // Gets or sets the Speaker Device Id
+        String SpeakerDeviceId{ get; set; };
     }
 
     // The manager class which encompasses all App Notification API Functionality

dev/AppNotifications/AppNotifications.vcxitems

@@ -24,6 +24,8 @@
     <ClInclude Include="$(MSBuildThisFileDirectory)NotificationTransientProperties.h" />
     <ClInclude Include="$(MSBuildThisFileDirectory)NotificationProgressData.h" />
     <ClInclude Include="$(MSBuildThisFileDirectory)ShellLocalization.h" />
+    <ClInclude Include="$(MSBuildThisFileDirectory)AppNotificationDevicesData.h" />
+    <ClInclude Include="$(MSBuildThisFileDirectory)NotificationDevicesData.h" />
   </ItemGroup>
   <ItemGroup>
     <ClCompile Include="$(MSBuildThisFileDirectory)AppNotificationActivatedEventArgs.cpp" />
@@ -35,6 +37,8 @@
     <ClCompile Include="$(MSBuildThisFileDirectory)NotificationTransientProperties.cpp" />
     <ClCompile Include="$(MSBuildThisFileDirectory)NotificationProgressData.cpp" />
     <ClCompile Include="$(MSBuildThisFileDirectory)ShellLocalization.cpp" />
+    <ClCompile Include="$(MSBuildThisFileDirectory)AppNotificationDevicesData.cpp" />
+    <ClCompile Include="$(MSBuildThisFileDirectory)NotificationDevicesData.cpp" />
   </ItemGroup>
   <ItemGroup>
     <Midl Include="$(MSBuildThisFileDirectory)AppNotifications.idl" />