diff options
| author | Dave Clark <[email protected]> | 2018-05-11 13:23:29 -0400 |
|---|---|---|
| committer | Dave Clark <[email protected]> | 2018-05-11 13:23:29 -0400 |
| commit | d02c0ae5e8f17d0846044fb31d243eaf77496bc3 (patch) | |
| tree | 4000a372bd535f8629c49c7019f66339fcfebf04 | |
| parent | Updates to NVIDIA Highlights FAQ (diff) | |
| download | gfesdk-d02c0ae5e8f17d0846044fb31d243eaf77496bc3.tar.xz gfesdk-d02c0ae5e8f17d0846044fb31d243eaf77496bc3.zip | |
Fix italics
| -rw-r--r-- | doc/NVIDIA_Highlights_FAQ.md | 34 |
1 files changed, 17 insertions, 17 deletions
diff --git a/doc/NVIDIA_Highlights_FAQ.md b/doc/NVIDIA_Highlights_FAQ.md index 78175cb..e97f9f0 100644 --- a/doc/NVIDIA_Highlights_FAQ.md +++ b/doc/NVIDIA_Highlights_FAQ.md @@ -3,26 +3,26 @@ This document covers the reasons for integrating Highlights, an explanation for how it works, and best practices for integration. ## Why integrate NVIDIA Highlights? -* NVIDIA Highlights enables gamers to automatically capture video and screenshots of the best moments of your game and share them to social media via the GeForce Experience In-game Overlay (aka the Overlay). -* NVIDIA’s ShadowPlay technology uses dedicated encoding hardware on the GPU so that these captures don’t impact gameplay. -* GeForce Experience handles all capture functionality, UI, and settings, making developer integration through a simple API (the GeForce Experience SDK, aka GFE-SDK) quick and easy. +* _NVIDIA Highlights_ enables gamers to automatically capture video and screenshots of the best moments of your game and share them to social media via the _GeForce Experience In-game Overlay_ (aka the _Overlay_). +* NVIDIA’s _ShadowPlay_ technology uses dedicated encoding hardware on the GPU so that these captures don’t impact gameplay. +* _GeForce Experience_ handles all capture functionality, UI, and settings, making developer integration through a simple API (the _GeForce Experience SDK_, aka _GFE-SDK_) quick and easy. ## How does NVIDIA Highlights work? -* Your game makes a Configure call on GFE-SDK to communicate all possible highlight types for the game. This in turn allows gamers to turn individual highlight types on and off in the Overlay. -* Your game makes a Create call to start a Highlights session. -* The first time your game tries to create a session, the Overlay asks the gamer for permission to make recordings of their gameplay. This is analogous to a mobile application asking for permission to use the phone’s camera. +* Your game makes a _Configure_ call on _GFE-SDK_ to communicate all possible highlight types for the game. This in turn allows gamers to turn individual highlight types on and off in the _Overlay_. +* Your game makes a Create call to start a Highlights _session_. +* The first time your game tries to create a session, the _Overlay_ asks the gamer for permission to make recordings of their gameplay. This is analogous to a mobile application asking for permission to use the phone’s camera.  -* Via the Settings menu of the Overlay, the gamer may turn highlights for all games on and off, highlights just for your game on and off, and turn each highlight type for your game on and off individually. -* When something worth capturing happens, your game makes a Set-Highlight call on GFE-SDK. This results in GFE-SDK saving a video recording or screenshot in a temporary folder the gamer has configured. -* GFE-SDK will announce each captured highlight with a notification to the gamer. Your game can also specify to GFE-SDK that the highlight be unannounced (e.g. if this would reveal too much to the gamer ‘in the moment’). Also, a gamer may turn off this type of notification via the Settings menu of the Overlay. -* A gamer uses your game’s UI element to launch the Highlights Summary. Be sure to follow the best practices listed at the end. -* The Highlights Summary shows the latest highlights and allows the gamer to preview each one. The gamer may edit and upload a capture directly from this NVIDIA provided UI. The gamer may also save a highlight to the Gallery, the part of the Overlay that manages the gamer’s captures. -* Once a highlight is saved to the Gallery it is accessible just like a video or a screenshot captured manually. The Gallery allows operations on content similar to those of the Highlights Summary including review, edit, and upload. +* Via the _Settings_ menu of the _Overlay_, the gamer may turn highlights for all games on and off, highlights just for your game on and off, and turn each highlight type for your game on and off individually. +* When something worth capturing happens, your game makes a _Set-Highlight_ call on _GFE-SDK_. This results in _GFE-SDK_ saving a video recording or screenshot in a temporary folder the gamer has configured. +* _GFE-SDK_ will announce each captured highlight with a notification to the gamer. Your game can also specify to _GFE-SDK_ that the highlight be unannounced (e.g. if this would reveal too much to the gamer ‘in the moment’). Also, a gamer may turn off this type of notification via the _Settings_ menu of the _Overlay_. +* A gamer uses your game’s UI element to launch the _Highlights Summary_. Be sure to follow the best practices listed at the end. +* The _Highlights Summary_ shows the latest highlights and allows the gamer to preview each one. The gamer may edit and upload a capture directly from this NVIDIA provided UI. The gamer may also save a highlight to _the Gallery_, the part of the _Overlay_ that manages the gamer’s captures. +* Once a highlight is saved to the _Gallery_ it is accessible just like a video or a screenshot captured manually. _The Gallery_ allows operations on content similar to those of the _Highlights Summary_ including review, edit, and upload. ## Should my game add UI to turn Highlights on and off? -* No, GFE-SDK takes care of this already by prompting for the user’s permission to use Highlights the first time a game attempts to use do so (as described above and shown below). +* No, _GFE-SDK_ takes care of this already by prompting for the user’s permission to use Highlights the first time a game attempts to use do so (as described above and shown below).  @@ -41,12 +41,12 @@ This document covers the reasons for integrating Highlights, an explanation for * Use the screenshot capability to capture moments such as victory or score screens. ## What are the best practices for adding a UI element in my game to open the Highlights Summary? -* Add an in-game UI element to launch the Highlights Summary in places that are easily accessible but won’t interfere with gameplay, e.g. on the end of match summary screen or in the main game menu. +* Add an in-game UI element to launch the _Highlights Summary_ in places that are easily accessible but won’t interfere with gameplay, e.g. on the end of match summary screen or in the main game menu.  * The button should be prominently displayed to allow users to easily find the feature. -* When implementing your UI element follow the “NVIDIA HIGHLIGHTS BUTTON PROPER USAGE” guidelines document in the GFE-SDK package adhering to the sizes, clear space, and specific colors prescribed there. The package also provides the necessary vector graphics assets files to do so. +* When implementing your UI element follow the “NVIDIA HIGHLIGHTS BUTTON PROPER USAGE” guidelines document in the _GFE-SDK_ package adhering to the sizes, clear space, and specific colors prescribed there. The package also provides the necessary vector graphics assets files to do so. ## When should I should I allow the user to open the Highlights Summary? * When the user has plenty of time to casually interact with their highlights. A short countdown timer before next round starts, where the level reloads and the user is back in the action, would not give the user time. @@ -58,5 +58,5 @@ This document covers the reasons for integrating Highlights, an explanation for ## Why does my game pause when the Summary is displayed when running in Windowed mode? -* The In-Game Overlay runs as a separate window that takes focus in windowed mode. Make sure your game continues to run normally when losing focus, including frame rate render speeds and sound creation. Dropping framerate or disabling sound on focus loss can break the user’s experience with NVIDIA Highlights. In some cases, we’ve seen applications minimize themselves on loss of focus, which will be very confusing to a user. -* Running in a separate window requires Aero support for best rendering performance. Desktop and window render rates will drop for any In-Game Overlay elements, including slider notifications for NVIDIA Highlights captures. This isn’t a major problem when the overlay or Summary dialog is displayed since they have the user’s attention, but can be distracting for framerate drops during game action from a Highlight capture notification. If your game supports non-Aero mode, you can limit the poor experience during gameplay by using the silent Highlight type, or ask the user to disable notifications in In-Game Overlay->Settings->Notifications. +* The In-Game Overlay runs as a separate window that takes focus in windowed mode. Make sure your game continues to run normally when losing focus, including frame rate render speeds and sound creation. Dropping framerate or disabling sound on focus loss can break the user’s experience with _NVIDIA Highlights_. In some cases, we’ve seen applications minimize themselves on loss of focus, which will be very confusing to a user. +* Running in a separate window requires Aero support for best rendering performance. Desktop and window render rates will drop for any In-Game Overlay elements, including slider notifications for _NVIDIA Highlights_ captures. This isn’t a major problem when the overlay or Summary dialog is displayed since they have the user’s attention, but can be distracting for framerate drops during game action from a Highlight capture notification. If your game supports non-Aero mode, you can limit the poor experience during gameplay by using the silent Highlight type, or ask the user to disable notifications in In-Game Overlay->Settings->Notifications. |