From 999d946d12902a9c465fd4fae282ebab4bf5a661 Mon Sep 17 00:00:00 2001 From: ktnrg45 <38207570+ktnrg45@users.noreply.github.com> Date: Sat, 19 Dec 2020 03:19:35 -0700 Subject: [PATCH] Update media data and port info for PS4 (#15947) Co-authored-by: Franck Nijhof --- source/_integrations/ps4.markdown | 43 ++++++++++++++----------------- 1 file changed, 20 insertions(+), 23 deletions(-) diff --git a/source/_integrations/ps4.markdown b/source/_integrations/ps4.markdown index 3e864a5bccc..efd999243f6 100644 --- a/source/_integrations/ps4.markdown +++ b/source/_integrations/ps4.markdown @@ -36,7 +36,7 @@ The `ps4` integration allows you to control a ## Granting Port Access -The PlayStation 4 integration requires the use of privileged ports to work correctly, specifically UDP port 987 and TCP port 997. Depending on your OS of your Home Assistant instance, you may need to allow usage of privileged ports manually. +The PlayStation 4 integration requires the use of privileged ports during configuration to work correctly, specifically UDP port 987 and TCP port 997. Depending on your OS of your Home Assistant instance, you may need to allow usage of privileged ports manually.
Do not run your Home Assistant Core instance itself as root or with root/sudo privileges to accomplish this. This would create a security risk for your host system. @@ -116,22 +116,11 @@ When running Home Assistant using Docker, make sure that the Home Assistant cont ## Regions -Some titles will have different SKUs in the PlayStation Store database, depending on your [region](https://www.playstation.com/country-selector/index.html). You must select your specific region in the setup in order to retrieve the cover art for such titles correctly. The integration will attempt to search other databases for the correct title if it cannot be found, although it will take longer to do so and may fetch an incorrect cover. - -| Available Regions | Unavailable Regions | -| --------------------------------------------------------------------------- | -------------------------- | -| Argentina, Australia, Austria, Bahrain, Belgium, Brazil, Bulgaria, | China, Japan, Philippines, | -| Canada, Chile, Columbia, Costa Rica, Croatia, Cyprus, Czech Republic, | Serbia, Ukraine, Vietnam | -| Denmark, Ecuador, El Salvador, Finland, France, Germany, Greece, Guatemala, | | -| Honduras, Hong Kong, Hungary, Iceland, India, Indonesia, Ireland, Israel, | | -| Italy, Korea, Kuwait, Lebanon, Luxembourg, Malta, Malaysia, Mexico, | | -| Middle East, Nederland, New Zealand, Nicaragua, Norway, Oman, Panama, | | -| Peru, Poland, Portugal, Qatar, Romania, Russia, Saudi Arabia, Singapore, | | -| Slovakia, Slovenia, South Africa, Spain, Sweden, Switzerland, Taiwan, | | -| Thailand, Turkey, United Arab Emirates, United Kingdom, United States | | +Some titles will have different SKUs in the PlayStation Store database, depending on your [region](https://www.playstation.com/country-selector/index.html). You must select your specific region in the setup in order to retrieve the cover art for such titles correctly. The integration will attempt to search other databases for the correct title if it cannot be found.
- The regions which are unavailable have no database or have formatting in the database, which can not be used by the component. + The following regions have no database and can not be used by the integration: + China, Philippines, Serbia, Vietnam.
## Media Data @@ -187,19 +176,19 @@ To edit, simply open the file in a text editor, find the game or app you would l Opens new application/game and closes currently running application/game. The game/app must be in the entity's source list. Games will be added automatically when you open them normally. -| Service data attribute | Optional | Example | Description | -| ---------------------- | -------- | ---------------------------- | ------------------------------------- | -| `entity_id` | No | `media_player.playstation_4` | The entity id for your PlayStation 4. | -| `source` | No | `Some Game` or `CUSA00123` | The game/app you want to open. You can use the title or SKU ID. Using the SKU ID will be the most reliable.| +| Service data attribute | Optional | Example | Description | +| ---------------------- | -------- | -------------------------- | ------------------------------------- | +| `entity_id` | No | `media_player.ps4` | The entity id for your PlayStation 4. | +| `source` | No | `Some Game` or `CUSA00123` | The game/app you want to open. You can use the title or SKU ID. Using the SKU ID will be the most reliable.| ### Service `send_command` Emulate button press on PlayStation 4. This emulates the commands available for the PS4 Second Screen App. This is not to be confused with DualShock 4 controller buttons. -| Service data attribute | Optional | Example | Description | -| ---------------------- | -------- | ---------------------------- | ------------------------------------- | -| `entity_id` | No | `media_player.playstation_4` | The entity id for your PlayStation 4. | -| `command` | No | `ps` | The command you want to send. | +| Service data attribute | Optional | Example | Description | +| ---------------------- | -------- | ------------------ | ------------------------------------- | +| `entity_id` | No | `media_player.ps4` | The entity id for your PlayStation 4. | +| `command` | No | `ps` | The command you want to send. | #### Available Commands @@ -228,3 +217,11 @@ Be sure to include the following information: As well as the exact values for the following attributes found in the state of your PS4 entity. - media_title - media_content_id + +## Advanced Use + +### Ports + +This integration uses UDP port 1987 as the source port during runtime. During configuration, the source port will be UDP port 1988. These port assignments can be used to configure firewall rules. + +In the event that these ports cannot be used, the ports will fallback to a random port.