XAppCapture

Xbox 和桌面包括本机广播体验，每个体验都有自己的规则，用户可以通过这些规则来广播应用程序。 通过这些 API，开发者可调出广播 UI 以及检测到用户何时进行广播。 应用开发者可以提供要使用已捕获的视频和音频文件/流进行保存或广播的元数据事件和状态。

函数

函数	说明
XAppBroadcastGetStatus	针对设备和当前应用检索广播的当前状态。
XAppBroadcastIsAppBroadcasting	确定应用当前是否正在广播。
XAppBroadcastMonitorCallback	设置 XAppBroadcastRegisterIsAppBroadcastingChanged 的回调函数。 每次更改广播状态时，将调用在此处设置的函数。
XAppBroadcastRegisterIsAppBroadcastingChanged	注册应用广播状态更改事件处理程序。
XAppBroadcastShowUI	向应用用户显示广播 UI，以便他们可以开始广播活动。
XAppBroadcastUnregisterIsAppBroadcastingChanged	删除应用广播状态更改事件处理程序。
XAppCaptureCloseLocalStream	关闭并删除指定的录制流。
XAppCaptureCloseScreenshotStream	关闭屏幕截图流。
XAppCaptureDisableRecord	为玩家禁用视频录制。
XAppCaptureEnableRecord	为当前用户启用录制/屏幕截图。
XAppCaptureGetVideoCaptureSettings	查询设备的 GameDVR 设置，这些设置包括编码类型、颜色格式、分辨率、可能的最大录制长度，以及当前用户是否允许按游戏捕获。
XAppCaptureMetadataAddDoubleEvent	将具有 double 值的元数据事件添加到应用捕获。
XAppCaptureMetadataAddInt32Event	将具有 Int32 值的元数据事件添加到应用捕获。
XAppCaptureMetadataAddStringEvent	将具有字符串值的元数据事件添加到应用程序捕获。
XAppCaptureMetadataPurgedCallback	设置当发生元数据清除时要调用的回调函数。
XAppCaptureMetadataRemainingStorageBytesAvailable	返回可用于应用捕获元数据的剩余存储。 以字节为单位。
XAppCaptureMetadataStartDoubleState	将具有 double 值的元数据状态添加到应用捕获。
XAppCaptureMetadataStartInt32State	将具有 Int32 值的元数据状态添加到应用捕获。
XAppCaptureMetadataStartStringState	将具有 string 值的元数据状态添加到应用捕获。
XAppCaptureMetadataStopAllStates	停止当前处于活动状态的所有状态事件。
XAppCaptureMetadataStopState	将特定命名状态的状态停止添加到应用捕获元数据。
XAppCaptureOpenScreenshotStream	打开屏幕截图流。
XAppCaptureReadLocalStream	读取由先前对 XAppCaptureRecordTimespan 的调用生成的 .mp4 文件的内容。
XAppCaptureReadScreenshotStream	读取屏幕截图流。
XAppCaptureRecordDiagnosticClip	从您的应用录制诊断剪辑。
XAppCaptureRecordTimespan	进行 GameDVR 录制。
XAppCaptureRegisterMetadataPurged	注册元数据清除事件的事件处理程序。
XAppCaptureStartUserRecord	像用户触发录制一样开始录制。
XAppCaptureStopUserRecord	停止通过 XAppCaptureStartUserRecord 启动且由输入的 ID 指定的正在进行的用户录制。
XAppCaptureTakeDiagnosticScreenshot	从您的应用截取诊断屏幕截图。
XAppCaptureTakeScreenshot	截取屏幕截图。
XAppCaptureUnRegisterMetadataPurged	删除元数据清除事件的事件处理程序。

结构

结构	说明
XAppBroadcastStatus	描述应用/游戏的广播能力状态。
XAppCaptureDiagnosticScreenshotResult	应用捕获屏幕截图以及描述性信息。
XAppCaptureLocalResult	包含调用 XAppCaptureRecordTimespan 的结果。
XAppCaptureRecordClipResult	捕获的视频剪辑以及描述性信息。
XAppCaptureScreenshotFile	捕获的屏幕截图以及描述性信息。
XAppCaptureScreenshotStream	表示屏幕截图流。
XAppCaptureTakeScreenshotResult	表示截取屏幕截图的结果。
XAppCaptureUserRecordingResult	包含调用 XAppCaptureStopUserRecord 的结果。
XAppCaptureVideoCaptureSettings	GameDVR 视频捕获设置。

枚举

枚举	说明
XAppCaptureMetadataPriority	应用捕获元数据的优先级。 当实施存储约束且必须删除一些元数据时，用于确定哪些数据最重要。
XAppCaptureScreenshotFormatFlag	确定屏幕截图捕获的清晰度。
XAppCaptureVideoColorFormat	GameDVR 录制中使用的颜色格式。
XAppCaptureVideoEncoding	确定视频编码类型视频捕获。

另请参阅

XAppCapture 错误代码
系统 API 参考