Broadcasting notifications and UI
XAppBroadcastGetStatus shows status updates on the state of broadcasting. Use this method to determine if a broadcast can start. Many factors go into determining if a broadcast can start, such as ensuring that the capture resource is available, if the game allows broadcasting, or the user and/or system hasn’t disabled broadcasting. If all members
of the XAppBroadcastStatus struct (besides canStartBroadcast) return
false, canStartBroadcast returns true. If a broadcast can start, call XAppBroadcastShowUI to show the broadcast UI for the
current user. Subsequently, the user must manually initiate the broadcast. XAppBroadcastIsAppBroadcasting is used to determine if the
current app is broadcasting. XAppBroadcastUnregisterIsAppBroadcasting is
used to unregister from change events from broadcast status.
Adding metadata to a screenshot, video clip, and broadcast
Several APIs are used to add and manage metadata that’s attached to a screenshot, video clip, or broadcast. Adding metadata is optional. However, it makes it easier for a user to find the recording that they want. Metadata can take many forms such as strings, integers, doubles. The system allocates storage space for metadata items. If the allocated space runs low,AppCaptureMetatPriority is used to determine the relative
priorities of the stored metadata items and the order in which metadata is purged to free up space.
Voice chat
Voice chat should be considered user generated content which can contain personally identifiable information or other potentially sensitive data. Because of this a user’s rendered voice in game chat should never be included in any recorded clips or game captures. This can be done by assigning the proper audio category to the render stream containing the user’s voice, that ofAudioCategory_GameChat. This tags the stream accordingly so that the system knows to ignore this audio stream when capturing for Game DVR clips.