getHdmiStatus

Get the HdmiStatus runtime API with query methods only

import { getHdmiStatus } from "@roku-sdk/runtime/hdmi-status";
getHdmiStatus(): Promise<HdmiStatus | null>

Description

Get the HdmiStatus runtime API with query methods only.

For reactive HDMI hot-plug and ALLM events, use useHdmiStatus.

Return values

Promise resolved with the safe HdmiStatus wrapper, or null when unavailable.

Types

HdmiStatus

Safe query surface exposed to app code (event handlers belong in useHdmiStatus).

type HdmiStatus = {
    apiVersion: number;
    isConnected: () => boolean;
    getHdcpVersion: () => string;
    isHdcpActive: (version: string) => boolean;
    getTVPowerStatus: () => TvPowerStatus;
};
NameTypeDescription
apiVersionnumberThe version of the runtime's HdmiStatus interface.
getHdcpVersion() => stringReturns the version of the HDCP link currently established on the HDMI output, such as "1.4" or "2.2".
getTVPowerStatus() => TvPowerStatusReturns the power state of the connected TV: "on", "standby" or "unknown".
isConnected() => booleanReturns true if the device's HDMI output is connected to another HDMI device.
isHdcpActive(version: string) => booleanReturns whether an HDCP link of the given version is active on the HDMI output.

What’s Next

Did this page help you?