// Copyright (c) 2015 Felix Rieseberg and Jason Poon // . All rights reserved. // Copyright (c) 2015 Ryan McShane and Brandon Smith // // Thanks to both of those folks mentioned above who first thought up a bunch of // this code // and released it as MIT to the world. #include "shell/browser/notifications/win/windows_toast_notification.h" #include #include #include #include "base/environment.h" #include "base/strings/utf_string_conversions.h" #include "base/task/post_task.h" #include "content/public/browser/browser_task_traits.h" #include "content/public/browser/browser_thread.h" #include "shell/browser/notifications/notification_delegate.h" #include "shell/browser/notifications/win/notification_presenter_win.h" #include "shell/browser/win/scoped_hstring.h" #include "shell/common/application_info.h" using ABI::Windows::Data::Xml::Dom::IXmlAttribute; using ABI::Windows::Data::Xml::Dom::IXmlDocument; using ABI::Windows::Data::Xml::Dom::IXmlDocumentIO; using ABI::Windows::Data::Xml::Dom::IXmlElement; using ABI::Windows::Data::Xml::Dom::IXmlNamedNodeMap; using ABI::Windows::Data::Xml::Dom::IXmlNode; using ABI::Windows::Data::Xml::Dom::IXmlNodeList; using ABI::Windows::Data::Xml::Dom::IXmlText; using Microsoft::WRL::Wrappers::HStringReference; #define RETURN_IF_FAILED(hr) \ do { \ HRESULT _hrTemp = hr; \ if (FAILED(_hrTemp)) { \ return _hrTemp; \ } \ } while (false) #define REPORT_AND_RETURN_IF_FAILED(hr, msg) \ do { \ HRESULT _hrTemp = hr; \ std::string _msgTemp = msg; \ if (FAILED(_hrTemp)) { \ std::string _err = _msgTemp + ",ERROR " + std::to_string(_hrTemp); \ if (IsDebuggingNotifications()) \ LOG(INFO) << _err; \ Notification::NotificationFailed(_err); \ return _hrTemp; \ } \ } while (false) namespace electron { namespace { bool IsDebuggingNotifications() { return base::Environment::Create()->HasVar("ELECTRON_DEBUG_NOTIFICATIONS"); } } // namespace // static ComPtr WindowsToastNotification::toast_manager_; // static ComPtr WindowsToastNotification::toast_notifier_; // static bool WindowsToastNotification::Initialize() { // Just initialize, don't care if it fails or already initialized. Windows::Foundation::Initialize(RO_INIT_MULTITHREADED); ScopedHString toast_manager_str( RuntimeClass_Windows_UI_Notifications_ToastNotificationManager); if (!toast_manager_str.success()) return false; if (FAILED(Windows::Foundation::GetActivationFactory(toast_manager_str, &toast_manager_))) return false; if (IsRunningInDesktopBridge()) { // Ironically, the Desktop Bridge / UWP environment // requires us to not give Windows an appUserModelId. return SUCCEEDED(toast_manager_->CreateToastNotifier(&toast_notifier_)); } else { ScopedHString app_id; if (!GetAppUserModelID(&app_id)) return false; return SUCCEEDED( toast_manager_->CreateToastNotifierWithId(app_id, &toast_notifier_)); } } WindowsToastNotification::WindowsToastNotification( NotificationDelegate* delegate, NotificationPresenter* presenter) : Notification(delegate, presenter) {} WindowsToastNotification::~WindowsToastNotification() { // Remove the notification on exit. if (toast_notification_) { RemoveCallbacks(toast_notification_.Get()); } } void WindowsToastNotification::Show(const NotificationOptions& options) { if (SUCCEEDED(ShowInternal(options))) { if (IsDebuggingNotifications()) LOG(INFO) << "Notification created"; if (delegate()) delegate()->NotificationDisplayed(); } } void WindowsToastNotification::Dismiss() { if (IsDebuggingNotifications()) LOG(INFO) << "Hiding notification"; toast_notifier_->Hide(toast_notification_.Get()); } HRESULT WindowsToastNotification::ShowInternal( const NotificationOptions& options) { ComPtr toast_xml; // The custom xml takes priority over the preset template. if (!options.toast_xml.empty()) { REPORT_AND_RETURN_IF_FAILED( XmlDocumentFromString(options.toast_xml.c_str(), &toast_xml), "XML: Invalid XML"); } else { auto* presenter_win = static_cast(presenter()); std::wstring icon_path = presenter_win->SaveIconToFilesystem(options.icon, options.icon_url); REPORT_AND_RETURN_IF_FAILED( GetToastXml(toast_manager_.Get(), options.title, options.msg, icon_path, options.timeout_type, options.silent, &toast_xml), "XML: Failed to create XML document"); } ScopedHString toast_str( RuntimeClass_Windows_UI_Notifications_ToastNotification); if (!toast_str.success()) { NotificationFailed("Creating ScopedHString failed"); return E_FAIL; } ComPtr toast_factory; REPORT_AND_RETURN_IF_FAILED( Windows::Foundation::GetActivationFactory(toast_str, &toast_factory), "WinAPI: GetActivationFactory failed"); REPORT_AND_RETURN_IF_FAILED(toast_factory->CreateToastNotification( toast_xml.Get(), &toast_notification_), "WinAPI: CreateToastNotification failed"); REPORT_AND_RETURN_IF_FAILED(SetupCallbacks(toast_notification_.Get()), "WinAPI: SetupCallbacks failed"); REPORT_AND_RETURN_IF_FAILED(toast_notifier_->Show(toast_notification_.Get()), "WinAPI: Show failed"); return S_OK; } HRESULT WindowsToastNotification::GetToastXml( ABI::Windows::UI::Notifications::IToastNotificationManagerStatics* toastManager, const std::wstring& title, const std::wstring& msg, const std::wstring& icon_path, const std::wstring& timeout_type, bool silent, IXmlDocument** toast_xml) { ABI::Windows::UI::Notifications::ToastTemplateType template_type; if (title.empty() || msg.empty()) { // Single line toast. template_type = icon_path.empty() ? ABI::Windows::UI::Notifications::ToastTemplateType_ToastText01 : ABI::Windows::UI::Notifications:: ToastTemplateType_ToastImageAndText01; REPORT_AND_RETURN_IF_FAILED( toast_manager_->GetTemplateContent(template_type, toast_xml), "XML: Fetching XML ToastImageAndText01 template failed"); std::wstring toastMsg = title.empty() ? msg : title; // we can't create an empty notification toastMsg = toastMsg.empty() ? L"[no message]" : toastMsg; REPORT_AND_RETURN_IF_FAILED( SetXmlText(*toast_xml, toastMsg), "XML: Filling XML ToastImageAndText01 template failed"); } else { // Title and body toast. template_type = icon_path.empty() ? ABI::Windows::UI::Notifications::ToastTemplateType_ToastText02 : ABI::Windows::UI::Notifications:: ToastTemplateType_ToastImageAndText02; REPORT_AND_RETURN_IF_FAILED( toastManager->GetTemplateContent(template_type, toast_xml), "XML: Fetching XML ToastImageAndText02 template failed"); REPORT_AND_RETURN_IF_FAILED( SetXmlText(*toast_xml, title, msg), "XML: Filling XML ToastImageAndText02 template failed"); } // Configure the toast's timeout settings if (timeout_type == base::ASCIIToUTF16("never")) { REPORT_AND_RETURN_IF_FAILED( (SetXmlScenarioReminder(*toast_xml)), "XML: Setting \"scenario\" option on notification failed"); } // Configure the toast's notification sound if (silent) { REPORT_AND_RETURN_IF_FAILED( SetXmlAudioSilent(*toast_xml), "XML: Setting \"silent\" option on notification failed"); } // Configure the toast's image if (!icon_path.empty()) { REPORT_AND_RETURN_IF_FAILED( SetXmlImage(*toast_xml, icon_path), "XML: Setting \"icon\" option on notification failed"); } return S_OK; } HRESULT WindowsToastNotification::SetXmlScenarioReminder(IXmlDocument* doc) { ScopedHString tag(L"toast"); if (!tag.success()) return false; ComPtr node_list; RETURN_IF_FAILED(doc->GetElementsByTagName(tag, &node_list)); // Check that root "toast" node exists ComPtr root; RETURN_IF_FAILED(node_list->Item(0, &root)); // get attributes of root "toast" node ComPtr attributes; RETURN_IF_FAILED(root->get_Attributes(&attributes)); ComPtr scenario_attribute; ScopedHString scenario_str(L"scenario"); RETURN_IF_FAILED(doc->CreateAttribute(scenario_str, &scenario_attribute)); ComPtr scenario_attribute_node; RETURN_IF_FAILED(scenario_attribute.As(&scenario_attribute_node)); ScopedHString scenario_value(L"reminder"); if (!scenario_value.success()) return E_FAIL; ComPtr scenario_text; RETURN_IF_FAILED(doc->CreateTextNode(scenario_value, &scenario_text)); ComPtr scenario_node; RETURN_IF_FAILED(scenario_text.As(&scenario_node)); ComPtr child_node; RETURN_IF_FAILED( scenario_attribute_node->AppendChild(scenario_node.Get(), &child_node)); ComPtr scenario_attribute_pnode; return attributes.Get()->SetNamedItem(scenario_attribute_node.Get(), &scenario_attribute_pnode); } HRESULT WindowsToastNotification::SetXmlAudioSilent(IXmlDocument* doc) { ScopedHString tag(L"toast"); if (!tag.success()) return E_FAIL; ComPtr node_list; RETURN_IF_FAILED(doc->GetElementsByTagName(tag, &node_list)); ComPtr root; RETURN_IF_FAILED(node_list->Item(0, &root)); ComPtr audio_element; ScopedHString audio_str(L"audio"); RETURN_IF_FAILED(doc->CreateElement(audio_str, &audio_element)); ComPtr audio_node_tmp; RETURN_IF_FAILED(audio_element.As(&audio_node_tmp)); // Append audio node to toast xml ComPtr audio_node; RETURN_IF_FAILED(root->AppendChild(audio_node_tmp.Get(), &audio_node)); // Create silent attribute ComPtr attributes; RETURN_IF_FAILED(audio_node->get_Attributes(&attributes)); ComPtr silent_attribute; ScopedHString silent_str(L"silent"); RETURN_IF_FAILED(doc->CreateAttribute(silent_str, &silent_attribute)); ComPtr silent_attribute_node; RETURN_IF_FAILED(silent_attribute.As(&silent_attribute_node)); // Set silent attribute to true ScopedHString silent_value(L"true"); if (!silent_value.success()) return E_FAIL; ComPtr silent_text; RETURN_IF_FAILED(doc->CreateTextNode(silent_value, &silent_text)); ComPtr silent_node; RETURN_IF_FAILED(silent_text.As(&silent_node)); ComPtr child_node; RETURN_IF_FAILED( silent_attribute_node->AppendChild(silent_node.Get(), &child_node)); ComPtr silent_attribute_pnode; return attributes.Get()->SetNamedItem(silent_attribute_node.Get(), &silent_attribute_pnode); } HRESULT WindowsToastNotification::SetXmlText(IXmlDocument* doc, const std::wstring& text) { ScopedHString tag; ComPtr node_list; RETURN_IF_FAILED(GetTextNodeList(&tag, doc, &node_list, 1)); ComPtr node; RETURN_IF_FAILED(node_list->Item(0, &node)); return AppendTextToXml(doc, node.Get(), text); } HRESULT WindowsToastNotification::SetXmlText(IXmlDocument* doc, const std::wstring& title, const std::wstring& body) { ScopedHString tag; ComPtr node_list; RETURN_IF_FAILED(GetTextNodeList(&tag, doc, &node_list, 2)); ComPtr node; RETURN_IF_FAILED(node_list->Item(0, &node)); RETURN_IF_FAILED(AppendTextToXml(doc, node.Get(), title)); RETURN_IF_FAILED(node_list->Item(1, &node)); return AppendTextToXml(doc, node.Get(), body); } HRESULT WindowsToastNotification::SetXmlImage(IXmlDocument* doc, const std::wstring& icon_path) { ScopedHString tag(L"image"); if (!tag.success()) return E_FAIL; ComPtr node_list; RETURN_IF_FAILED(doc->GetElementsByTagName(tag, &node_list)); ComPtr image_node; RETURN_IF_FAILED(node_list->Item(0, &image_node)); ComPtr attrs; RETURN_IF_FAILED(image_node->get_Attributes(&attrs)); ScopedHString src(L"src"); if (!src.success()) return E_FAIL; ComPtr src_attr; RETURN_IF_FAILED(attrs->GetNamedItem(src, &src_attr)); ScopedHString img_path(icon_path.c_str()); if (!img_path.success()) return E_FAIL; ComPtr src_text; RETURN_IF_FAILED(doc->CreateTextNode(img_path, &src_text)); ComPtr src_node; RETURN_IF_FAILED(src_text.As(&src_node)); ComPtr child_node; return src_attr->AppendChild(src_node.Get(), &child_node); } HRESULT WindowsToastNotification::GetTextNodeList(ScopedHString* tag, IXmlDocument* doc, IXmlNodeList** node_list, uint32_t req_length) { tag->Reset(L"text"); if (!tag->success()) return E_FAIL; RETURN_IF_FAILED(doc->GetElementsByTagName(*tag, node_list)); uint32_t node_length; RETURN_IF_FAILED((*node_list)->get_Length(&node_length)); return node_length >= req_length; } HRESULT WindowsToastNotification::AppendTextToXml(IXmlDocument* doc, IXmlNode* node, const std::wstring& text) { ScopedHString str(text); if (!str.success()) return E_FAIL; ComPtr xml_text; RETURN_IF_FAILED(doc->CreateTextNode(str, &xml_text)); ComPtr text_node; RETURN_IF_FAILED(xml_text.As(&text_node)); ComPtr append_node; RETURN_IF_FAILED(node->AppendChild(text_node.Get(), &append_node)); return S_OK; } HRESULT WindowsToastNotification::XmlDocumentFromString( const wchar_t* xmlString, IXmlDocument** doc) { ComPtr xmlDoc; RETURN_IF_FAILED(Windows::Foundation::ActivateInstance( HStringReference(RuntimeClass_Windows_Data_Xml_Dom_XmlDocument).Get(), &xmlDoc)); ComPtr docIO; RETURN_IF_FAILED(xmlDoc.As(&docIO)); RETURN_IF_FAILED(docIO->LoadXml(HStringReference(xmlString).Get())); return xmlDoc.CopyTo(doc); } HRESULT WindowsToastNotification::SetupCallbacks( ABI::Windows::UI::Notifications::IToastNotification* toast) { event_handler_ = Make(this); RETURN_IF_FAILED( toast->add_Activated(event_handler_.Get(), &activated_token_)); RETURN_IF_FAILED( toast->add_Dismissed(event_handler_.Get(), &dismissed_token_)); RETURN_IF_FAILED(toast->add_Failed(event_handler_.Get(), &failed_token_)); return S_OK; } bool WindowsToastNotification::RemoveCallbacks( ABI::Windows::UI::Notifications::IToastNotification* toast) { if (FAILED(toast->remove_Activated(activated_token_))) return false; if (FAILED(toast->remove_Dismissed(dismissed_token_))) return false; return SUCCEEDED(toast->remove_Failed(failed_token_)); } /* / Toast Event Handler */ ToastEventHandler::ToastEventHandler(Notification* notification) : notification_(notification->GetWeakPtr()) {} ToastEventHandler::~ToastEventHandler() {} IFACEMETHODIMP ToastEventHandler::Invoke( ABI::Windows::UI::Notifications::IToastNotification* sender, IInspectable* args) { base::PostTask( FROM_HERE, {content::BrowserThread::UI}, base::BindOnce(&Notification::NotificationClicked, notification_)); if (IsDebuggingNotifications()) LOG(INFO) << "Notification clicked"; return S_OK; } IFACEMETHODIMP ToastEventHandler::Invoke( ABI::Windows::UI::Notifications::IToastNotification* sender, ABI::Windows::UI::Notifications::IToastDismissedEventArgs* e) { base::PostTask( FROM_HERE, {content::BrowserThread::UI}, base::BindOnce(&Notification::NotificationDismissed, notification_)); if (IsDebuggingNotifications()) LOG(INFO) << "Notification dismissed"; return S_OK; } IFACEMETHODIMP ToastEventHandler::Invoke( ABI::Windows::UI::Notifications::IToastNotification* sender, ABI::Windows::UI::Notifications::IToastFailedEventArgs* e) { HRESULT error; e->get_ErrorCode(&error); std::string errorMessage = "Notification failed. HRESULT:" + std::to_string(error); base::PostTask(FROM_HERE, {content::BrowserThread::UI}, base::BindOnce(&Notification::NotificationFailed, notification_, errorMessage)); if (IsDebuggingNotifications()) LOG(INFO) << errorMessage; return S_OK; } } // namespace electron