Skip to content

Commit 6dbba25

Browse files
alvinashcraftalvinashcraft
committed
Merge branch 'main' into alvinashcraft/main-update-settings-uri-parameters
2 parents 9924927 + 8b78e6a commit 6dbba25

File tree

4 files changed

+45
-47
lines changed

4 files changed

+45
-47
lines changed

‎hub/apps/publish/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: Learn how to publish your Windows apps and games to the Microsoft Store.
33
title: Publish Windows apps and games to Microsoft Store
4-
ms.date: 10/30/2022
4+
ms.date: 12/4/2024
55
ms.topic: article
66
keywords: windows 10, uwp, publishing, publish, selling, sell, distribute, distributing, store, dashboard
77
ms.assetid: 631d1e2d-e4da-4740-ace0-4c0ad78653fe

‎hub/apps/publish/publish-your-app/pwa/age-ratings.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: The Age ratings page of the app submission process lets you provide information about your PWA app so it can receive the appropriate age ratings from the International Age Ratings Coalition (IARC).
33
title: Age ratings for PWA
4-
ms.date: 10/30/2022
4+
ms.date: 12/5/2024
55
ms.topic: article
66
ms.localizationpriority: medium
77
---

‎uwp/launch-resume/launch-app-with-uri.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Launch an app with a URI
33
description: This section describes how to use a Uniform Resource Identifier (URI) to launch one app from another app.
44
ms.assetid: a40c4ce2-4f41-4a55-aeb3-1beb3e84e839
5-
ms.date: 02/08/2017
5+
ms.date: 12/06/2024
66
ms.topic: article
77
keywords: windows 10, uwp
88
ms.localizationpriority: medium
@@ -24,5 +24,6 @@ This section describes how to use a Uniform Resource Identifier (URI) to launch
2424
| [Launch screen snipping](launch-screen-snipping.md) | Learn how to use URI schemes to open a new snip, or to open the Snip & Sketch app. |
2525
| [Enable apps for websites using app URI handlers](web-to-app-linking.md) | Drive user engagement with your app by supporting the Apps for Websites feature. |
2626

27-
## Related Topics
28-
* [Launch an app on a remote device](launch-a-remote-app.md)
27+
## Related content
28+
29+
- [Launch an app on a remote device](launch-a-remote-app.md)

‎uwp/launch-resume/launch-default-app.md

Lines changed: 39 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,6 @@ ms.localizationpriority: medium
99
---
1010
# Launch the default app for a URI
1111

12-
1312
**Important APIs**
1413

1514
- [**LaunchUriAsync**](/uwp/api/windows.system.launcher.launchuriasync)
@@ -24,30 +23,28 @@ This topic describes the following URI schemes built into Windows:
2423

2524
| URI Scheme | Launches |
2625
| ----------:|----------|
27-
|[bingmaps:, ms-drive-to:, and ms-walk-to: ](#maps-app-uri-schemes) | Maps app |
28-
|[http:](#http-uri-scheme) | Default web browser |
29-
|[mailto:](#email-uri-scheme) | Default email app |
30-
|[ms-call:](#call-app-uri-scheme) | Call app |
31-
|[ms-chat:](#messaging-app-uri-scheme) | Messaging app |
32-
|[ms-people:](#people-app-uri-scheme) | People app |
33-
|[ms-photos:](#photos-app-uri-scheme) | Photos app |
34-
|[ms-settings:](#settings-app-uri-scheme) | Settings app |
35-
|[ms-store:](#store-app-uri-scheme) | Store app |
36-
|[ms-tonepicker:](#tone-picker-uri-scheme) | Tone picker |
37-
|[ms-yellowpage:](#nearby-numbers-app-uri-scheme) | Nearby Numbers app |
38-
|[msnweather:](#weather-app-uri-scheme) | Weather app |
39-
|[microsoft-edge:](#microsoft-edge-uri-scheme) | Microsoft Edge browser |
40-
41-
<br>
42-
For example, the following URI opens the default browser and displays the Bing web site.
43-
44-
`https://bing.com`
26+
| [bingmaps:, ms-drive-to:, and ms-walk-to:](#maps-app-uri-schemes) | Maps app |
27+
| [http: and https:](#http-uri-scheme) | Default web browser |
28+
| [mailto:](#email-uri-scheme) | Default email app |
29+
| [ms-call:](#call-app-uri-scheme) | Call app |
30+
| [ms-chat:](#messaging-app-uri-scheme) | Messaging app |
31+
| [ms-people:](#people-app-uri-scheme) | People app |
32+
| [ms-photos:](#photos-app-uri-scheme) | Photos app |
33+
| [ms-settings:](#settings-app-uri-scheme) | Settings app |
34+
| [ms-store:](#store-app-uri-scheme) | Store app |
35+
| [ms-tonepicker:](#tone-picker-uri-scheme) | Tone picker |
36+
| [ms-yellowpage:](#nearby-numbers-app-uri-scheme) | Nearby Numbers app |
37+
| [msnweather:](#weather-app-uri-scheme) | Weather app |
38+
| [microsoft-edge:](#microsoft-edge-uri-scheme) | Microsoft Edge browser |
39+
| [ms-recall:](/windows/ai/apis/recall#launch-click-to-do) >>> | Click to do (part of [Recall](/windows/ai/apis/recall)). |
40+
41+
For example, the following URI opens the default browser and displays the Microsoft Bing web site: `https://bing.com/`.
4542

4643
You can also launch custom URI schemes too. If there is no app installed to handle that URI, you can recommend an app for the user to install. For more info, see [Recommend an app if one is not available to handle the URI](#recommend-an-app-if-one-is-not-available-to-handle-the-uri).
4744

4845
In general, your app can't select the app that is launched. The user determines which app is launched. More than one app can register to handle the same URI scheme. The exception to this is for reserved URI schemes. Registrations of reserved URI schemes are ignored. For the full list of reserved URI schemes, see [Handle URI activation](handle-uri-activation.md). In cases where more than one app may have registered the same URI scheme, your app can recommend a specific app to be launched. For more info, see [Recommend an app if one is not available to handle the URI](#recommend-an-app-if-one-is-not-available-to-handle-the-uri).
4946

50-
### Call LaunchUriAsync to launch a URI
47+
## Call LaunchUriAsync to launch a URI
5148

5249
Use the [**LaunchUriAsync**](/uwp/api/windows.system.launcher.launchuriasync) method to launch a URI. When you call this method, your app must be the foreground app, that is, it must be visible to the user. This requirement helps ensure that the user remains in control. To meet this requirement, make sure that you tie all URI launches directly to the UI of your app. The user must always take some action to initiate a URI launch. If you attempt to launch a URI and your app isn't in the foreground, the launch will fail and your error callback will be invoked.
5350

@@ -125,7 +122,7 @@ options.DesiredRemainingView = Windows.UI.ViewManagement.ViewSizePreference.UseL
125122
var success = await Windows.System.Launcher.LaunchUriAsync(uriContoso, options);
126123
```
127124

128-
## URI Schemes ##
125+
## URI Schemes
129126

130127
The various URI schemes are described below.
131128

@@ -135,24 +132,24 @@ Use the **ms-call:** URI scheme to launch the Call app.
135132

136133
| URI Scheme | Result |
137134
|------------------|--------------------------|
138-
| ms-call:settings | Calls app settings page. |
135+
| `ms-call:settings` | Calls app settings page. |
139136

140137
### Email URI scheme
141138

142139
Use the **mailto:** URI scheme to launch the default mail app.
143140

144-
| URI Scheme |Results |
145-
|------------|---------------------------------|
146-
| mailto: | Launches the default email app. |
147-
| mailto:\[email address\] | Launches the email app and creates a new message with the specified email address on the To line. Note that the email is not sent until the user taps send. |
141+
| URI Scheme |Results |
142+
|------------|--------|
143+
| `mailto:` | Launches the default email app. |
144+
| `mailto:\[email address\]` | Launches the email app and creates a new message with the specified email address on the To line. Note that the email is not sent until the user taps send. |
148145

149146
### HTTP URI scheme
150147

151148
Use the **http:** URI scheme to launch the default web browser.
152149

153-
| URI Scheme | Results |
154-
|------------|-----------------------------------|
155-
| http: | Launches the default web browser. |
150+
| URI Scheme | Results |
151+
|------------|---------|
152+
| `http:` | Launches the default web browser. |
156153

157154
### Maps app URI schemes
158155

@@ -170,19 +167,19 @@ Use the **ms-chat:** URI scheme to launch the Windows Messaging app.
170167

171168
| URI scheme |Results |
172169
|------------|--------|
173-
| ms-chat: | Launches the Messaging app. |
174-
| ms-chat:?ContactID={contacted} | Allows the messaging application to be launched with a particular contact’s information. |
175-
| ms-chat:?Body={body} | Allows the messaging application to be launched with a string to use as the content of the message.|
176-
| ms-chat:?Addresses={address}&Body={body} | Allows the messaging application to be launched with a particular addresses' information, and with a string to use as the content of the message. Note: Addresses can be concatenated. |
177-
| ms-chat:?TransportId={transportId} | Allows the messaging application to be launched with a particular transport ID. |
170+
| `ms-chat:` | Launches the Messaging app. |
171+
| `ms-chat:?ContactID={contacted}` | Allows the messaging application to be launched with a particular contact’s information. |
172+
| `ms-chat:?Body={body}` | Allows the messaging application to be launched with a string to use as the content of the message.|
173+
| `ms-chat:?Addresses={address}&Body={body}` | Allows the messaging application to be launched with a particular addresses' information, and with a string to use as the content of the message. Note: Addresses can be concatenated. |
174+
| `ms-chat:?TransportId={transportId}` | Allows the messaging application to be launched with a particular transport ID. |
178175

179176
### Tone picker URI scheme
180177

181178
Use the **ms-tonepicker:** URI scheme to choose ringtones, alarms, and system tones. You can also save new ringtones and get the display name of a tone.
182179

183180
| URI Scheme | Results |
184181
|------------|---------|
185-
| ms-tonepicker: | Pick ringtones, alarms, and system tones. |
182+
| `ms-tonepicker:` | Pick ringtones, alarms, and system tones. |
186183

187184
Parameters are passed via a [ValueSet](/uwp/api/windows.foundation.collections.valueset) to the LaunchURI API. See [Choose and save tones using the ms-tonepicker URI scheme](launch-ringtone-picker.md) for details.
188185

@@ -192,7 +189,7 @@ Use the **ms-yellowpage:** URI scheme to launch the Nearby Numbers app.
192189

193190
| URI Scheme | Results |
194191
|------------|---------|
195-
| ms-yellowpage:?input=\[keyword\]&method=\[String or T9\] | Launches the Nearby Numbers app.<br>`input` refers to the keyword you want to search.<br>`method` refers to the type of search (string or T9 search).<br>If `method` is `T9` (a type of keyboard) then `keyword` should be a numeric string that maps to the T9 keyboard letters to search for.<br>If `method` is `String` then `keyword` is the keyword to search for. |
192+
| `ms-yellowpage:?input=\[keyword\]&method=\[String or T9\]` | Launches the Nearby Numbers app.<br>`input` refers to the keyword you want to search.<br>`method` refers to the type of search (string or T9 search).<br>If `method` is `T9` (a type of keyboard) then `keyword` should be a numeric string that maps to the T9 keyboard letters to search for.<br>If `method` is `String` then `keyword` is the keyword to search for. |
196193

197194
### People app URI scheme
198195

@@ -210,10 +207,10 @@ Or to edit a video: `ms-photos:videoedit?InputToken=123abc&Action=Trim&StartTime
210207
211208
| URI scheme |Results |
212209
|------------|--------|
213-
| ms-photos:viewer?fileName={filename} | Launches the Photos app to view the specified image where {filename} is a fully-qualified path name. For example: `c:\users\userName\Pictures\ImageToView.jpg` |
214-
| ms-photos:videoedit?InputToken={input token} | Launches the Photos app in video editing mode for the file represented by the file token. **InputToken** is required. Use the [SharedStorageAccessManager](/uwp/api/Windows.ApplicationModel.DataTransfer.SharedStorageAccessManager) to get a token for a file. |
215-
| ms-photos:videoedit?Action={action} | A parameter that indicates which video editing mode to open the Photos app in, where {action} is one of: **SlowMotion**, **FrameExtraction**, **Trim**, **View**, **Ink**. **Action** is required. |
216-
| ms-photos:videoedit?StartTime={timespan} | An optional parameter that specifies where to start playing the video. `{timespan}` must be in the format `"hh:mm:ss.ffff"`. If not specified, defaults to `00:00:00.0000` |
210+
| `ms-photos:viewer?fileName={filename}` | Launches the Photos app to view the specified image where {filename} is a fully-qualified path name. For example: `c:\users\userName\Pictures\ImageToView.jpg` |
211+
| `ms-photos:videoedit?InputToken={input token}` | Launches the Photos app in video editing mode for the file represented by the file token. **InputToken** is required. Use the [SharedStorageAccessManager](/uwp/api/Windows.ApplicationModel.DataTransfer.SharedStorageAccessManager) to get a token for a file. |
212+
| `ms-photos:videoedit?Action={action}` | A parameter that indicates which video editing mode to open the Photos app in, where {action} is one of: **SlowMotion**, **FrameExtraction**, **Trim**, **View**, **Ink**. **Action** is required. |
213+
| `ms-photos:videoedit?StartTime={timespan}` | An optional parameter that specifies where to start playing the video. `{timespan}` must be in the format `"hh:mm:ss.ffff"`. If not specified, defaults to `00:00:00.0000` |
217214

218215
### Settings app URI scheme
219216

@@ -239,12 +236,12 @@ Use the **msnweather:** URI scheme to launch the Weather app.
239236

240237
| URI Scheme | Results |
241238
|------------|---------|
242-
| msnweather://forecast?la=\[latitude\]&lo=\[longitude\] | Launches the Weather app in the Forecast page based on a location geographic coordinates.<br>`latitude` refers to the latitude of the location.<br> `longitude` refers to the longitude of the location.<br> |
239+
| `msnweather://forecast?la=\[latitude\]&lo=\[longitude\]` | Launches the Weather app in the Forecast page based on a location geographic coordinates.<br>`latitude` refers to the latitude of the location.<br> `longitude` refers to the longitude of the location. |
243240

244241
### Microsoft Edge URI scheme
245242

246243
Use the **microsoft-edge:** URI scheme to launch the Microsoft Edge browser to a specified URL.
247244

248245
| URI Scheme | Results |
249246
|------------|---------|
250-
| microsoft-edge:https://example.com/] | Opens the Microsoft Edge browser and navigates to https://example.com/<br> |
247+
| `microsoft-edge:https://example.com/` | Opens the Microsoft Edge browser and navigates to `https://example.com/` |

0 commit comments

Comments
 (0)