diff --git a/api/@ohos.PiPWindow.d.ts b/api/@ohos.PiPWindow.d.ts
index 206fc082fef20a9d2743812b3aae8673c5eb9ba6..b02f294486509e607931f9cfd21f7bdadbe4b70f 100644
--- a/api/@ohos.PiPWindow.d.ts
+++ b/api/@ohos.PiPWindow.d.ts
@@ -1084,6 +1084,17 @@ declare namespace PiPWindow {
      */
      getPiPWindowInfo(): Promise<PiPWindowInfo>;
 
+     /**
+     * Get the PiP switch status of system setting.
+     * @returns { Promise<boolean> } - The promise used to return the PIP switch status.
+     * @throws { BusinessError } 801 - Capability not supported. Failed to call the API due to limited device capabilities.
+     * @throws { BusinessError } 1300014 - PiP internal error.
+     * @syscap SystemCapability.Window.SessionManager
+     * @atomicservice
+     * @since 20
+     */
+     getPiPSettingSwitch(): Promise<boolean>;
+
     /**
      * Register picture-in-picture control event listener.
      * @param { 'stateChange' } type - Registration type, PiP lifecycle state change, 'stateChange'