From 695e95f856ba8cbac3e1b75f35a9db2201a17c9d Mon Sep 17 00:00:00 2001 From: Jack Powell Date: Tue, 24 Jun 2025 09:22:28 -0400 Subject: [PATCH] Add PlayStation Network Documentation (#36520) Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Co-authored-by: Joost Lekkerkerker --- .../playstation_network.markdown | 92 +++++++++++++++++++ 1 file changed, 92 insertions(+) create mode 100644 source/_integrations/playstation_network.markdown diff --git a/source/_integrations/playstation_network.markdown b/source/_integrations/playstation_network.markdown new file mode 100644 index 00000000000..69a0d6353fc --- /dev/null +++ b/source/_integrations/playstation_network.markdown @@ -0,0 +1,92 @@ +--- +title: PlayStation Network +description: Instructions on enabling PlayStation Network support for your Home Assistant +ha_category: + - Media player +ha_release: 2025.7 +ha_iot_class: Cloud Polling +ha_domain: playstation_network +ha_platforms: + - media_player +ha_codeowners: + - '@jackjpowell' +ha_config_flow: true +ha_quality_scale: bronze +ha_integration_type: integration +related: + - url: https://playstation.com/ + title: Playstation +--- + +The **PlayStation Network** {% term integration %} enables you to seamlessly integrate information from your currently playing game in Home Assistant. + +## About PlayStation Network + +PlayStation Network (PSN) is a digital media entertainment service provided by [Sony Interactive Entertainment](https://en.wikipedia.org/wiki/Sony_Interactive_Entertainment). It allows users to enjoy a variety of gaming-related services such as purchasing games, downloading content, and connecting with other players. + +## How you can use this integration + +The **PlayStation Network** {% term integration %} lets you integrate information about your currently playing game into Home Assistant. You can display the game title and cover art in your Home Assistant dashboards. + +## Prerequisites + +- To set up the PlayStation Network integration, you must first have an active PlayStation Network account. You can register for an account at the [Official PlayStation® Site](https://playstation.com/). +- During the setup process in Home Assistant, you will be asked to provide your NPSSO token. You will need to be logged into [playstation.com](https://playstation.com/) to access the token in your browser. You will find a link to retrieve the token in the config flow. + +{% include integrations/config_flow.md %} + +### Login to PlayStation Network + +{% configuration_basic %} +"NPSSO Token": + description: "Supply your NPSSO token after successfully logging into the PlayStationNetwork in your browser." + required: true + type: string +{% endconfiguration_basic %} + +## Supported functionality + +### Media players + +- **PlayStation Console**: One Media Player will be created for any [supported PlayStation console](#supported-devices) you have connected to the PlayStation Network. The artwork and title of the currently playing game will be populated. + +## Data updates + +This integration retrieves data from the PlayStation Network every 30 seconds to ensure timely updates. + +## Known limitations + +PlayStation Network imposes a rate limit of 300 requests per 15 minutes. + +This integration makes 3 requests per data update (every 30 seconds). This presently is well under the rate limit, but leaves room to add additional requests as the integration develops. + +Please keep these limits in mind to avoid exceeding the PlayStation Network request allowance. + +The Active state for each device is only reported via the API for the last used device. For example, if you start playing a game on your PS4 and without powering down, launch a game on your PS5, the API will only report your PS5 status. + +## Supported devices + +The following devices are known to be supported by the integration: + +- PlayStation 5 +- PlayStation 4 +- PlayStation 3 +- PlayStation PC + +## Unsupported devices + +The following devices are not supported by the integration: + +- PlayStation Vita +- PlayStation Portable +- Other PlayStation system variants (PlayStation TV) or older systems that do not support the PlayStation Network + +## Use cases + +You can display your currently playing game as artwork on your dashboard. + +## Remove integration + +This integration can be removed by following these steps: + +{% include integrations/remove_device_service.md %}