Samsung app docs migrated from app repo to meta repo for storage

App-Documentation-Samsung/README.md

@@ -0,0 +1,67 @@
+<!-- markdownlint-disable MD041 first-line-heading -->
+<h1 align="center">Jellyfin - Samsung app documentation repo</h1>
+<h3 align="center">Part of the <a href="https://jellyfin.org">Jellyfin Project</a></h3>
+
+---
+
+<p align="center">
+<img alt="Logo Banner" src="https://raw.githubusercontent.com/jellyfin/jellyfin-ux/master/branding/SVG/banner-logo-solid.svg?sanitize=true"/>
+</p>
+
+---
+
+This folder contains documentation and screenshots for the Samsung store app listing process.
+
+It is split into subfolders for each area of the certification process, the readme in the "docs" folder is cross linked to other documentation areas.
+
+Initial work was carried out in this <a><a href="https://github.com/jellyfin/jellyfin-tizen/pull/307#issuecomment-2567142677">pull request</a> Then migrated over to here for storage and to keep the app repo clear.
+
+---
+
+In order to publish an application, we'll be following Samsung's official guide: [TV Application Publication Process](https://developer.samsung.com/tv-seller-office/guides/applications/tv-app-publication-process.html).
+
+Overall Steps:
+
+Registration & Upgrade
+Certification & Verification
+Release
+
+
+# Submission Process
+
+## Registration & Upgrade
+
+[Registering Applications](https://developer.samsung.com/tv-seller-office/guides/applications/registering-application.html)
+- [X] Generate Application ID
+- [ ] Upload Application Package
+
+[Entering Application Information](https://developer.samsung.com/tv-seller-office/guides/applications/entering-application-information.html)
+- [ ] [Registering Application Image](https://developer.samsung.com/tv-seller-office/guides/applications/entering-application-information.html#Registering-Application-Image) (Icons, Screenshots)
+- [ ] Entering Application Title and Description (We have text we can use)
+- [ ] Entering Service Information (We can fill in our contact info)
+- [ ] Setting Service Country (We don't plan on any restrictions, all available countries will be allowed)
+- [ ] Entering Billing Information (N/A, we will choose "Free")
+- [ ] Entering Application Feature Information (I believe HDR, and Player)
+- [ ] [Entering Verification Information](https://developer.samsung.com/tv-seller-office/guides/applications/entering-application-information.html#Entering-Verification-Information)
+
+
+## Documentation for project response sections
+
+- [Section 1 - UI Structure](/App-Documentation-Samsung/docs/App-UI-Description/1-UI-Structure/README.md)
+
+- [Section 2 - Use Cases](/App-Documentation-Samsung/docs/App-UI-Description/2-Use-Cases/README.md)
+
+- [Section 3 - Menus and Functions](/App-Documentation-Samsung/docs/App-UI-Description/3-Menus-and-Functions/README.md)
+
+- [Section 4 - Remote Control Keys](/App-Documentation-Samsung/docs/App-UI-Description/4-Remote-Control-Keys/README.md)
+
+- [Section 5 - Language Options](/App-Documentation-Samsung/docs/App-UI-Description/5-Language-Options/README.md)
+
+## Certification & Verification
+
+- [ ] Request Release, which submits for Testing
+
+
+## Release
+
+- [ ] Set Application Status to "For Sale"

App-Documentation-Samsung/docs/App Information/App Icons/README.md

@@ -0,0 +1,11 @@
+# App Icon
+
+We need 3 images with this characteristics, more info [here](https://developer.samsung.com/smarttv/design/app-icons-and-screenshots.html#app-icon):
+
+- 2015 TV 
+  - [X] .PNG (24 bit & RGB) - Max 300 kB (72 DPI) - 512x423 px ([logo_jellyfin_fg.png](./2015/logo_jellyfin_fg.png))
+- \>=2016 TV
+  - [X] Foreground - .PNG (32 bit & RGBA) - Max 300 kB - 1920x1080 px ([logo_jellyfin_fg.png](./2016/logo_jellfyfin_fg.png))
+  - [X] Background - .PNG (24 bit & RGB) - Max 300 kB - 1920x1080 px ([logo_jellyfin_bg.png](./2016/logo_jellyfin_bg.png))
+
+Images are copied (and renamed) from [jellyfin/jellyfin-ux](https://github.com/jellyfin/jellyfin-ux/tree/master/branding/tizen).

App-Documentation-Samsung/docs/App Information/Screenshots/README.md

@@ -0,0 +1,32 @@
+# App Icon
+
+## Samsung Requirements
+
+We need 4 images with these characteristics based on Samsung documentation.
+
+Info [here](https://developer.samsung.com/smarttv/design/app-icons-and-screenshots.html#App-Screenshot):
+
+And 
+[here](https://developer.samsung.com/tv-seller-office/application-publication-process.html#Publishing-New-Applications):
+
+Note - first link does not specify file type, second link specifies JPG - so JPG selected for screenshots (PNG is a must for icons)
+
+|Application package | Dimensions | Format | Maximum Size | 
+|----------------|--------|--------|--------|
+|Application screenshot image | 1280x720 px or 1920x1080 px | JPG | 500 kB |
+
+
+- 1920 X 1080 px
+- JPG
+- 500kB or less
+- names must be screenshot_appname0X.png (where X is the image number)
+
+Screenshots might need to be taken on a server with only child appropriate content to prevent any issues with the app age rating.
+
+## Images Selected
+
+- [X] [Home page image](./screenshot_jellyfin01.png)
+- [X] [Movies page image](./screenshot_jellyfin02.png)
+- [X] [Movies detail page image](./screenshot_jellyfin03.png)
+- [X] [Player image](./screenshot_jellyfin04.png)
+- [X] [Actor page image](./screenshot_jellyfin05.png)

App-Documentation-Samsung/docs/App-UI-Description/1-UI-Structure/README.md

@@ -0,0 +1,26 @@
+# UI Structure
+
+## Colaborative workspace
+
+I have created a google slides [HERE](https://docs.google.com/presentation/d/1RaFaoxFI94UVqH53_3I8fuviq9ktNy0hMoSBGLhgWUE/edit?usp=sharing).
+
+We can then export to png for upload to Samsung
+
+## Samsung requirements
+
+Illustrate the complete UI structure of your application.
+
+− All application screens and navigation paths must be included
+
+Use a flow graph, tree structure, or depth navigation diagram
+
+<p align="center">
+<img alt="Flow example" src="https://developer.samsung.com/media/3111/flowgraph_2018-04-06.png"/>
+</p>
+
+
+
+## Project Response Section
+
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide01.png"/></a>

App-Documentation-Samsung/docs/App-UI-Description/2-Use-Cases/README.md

@@ -0,0 +1,71 @@
+# Use Cases
+
+## Colaborative workspace
+
+I have created a google slides [HERE](https://docs.google.com/presentation/d/1BVVMcW2MJzI41EFU_VNMalA7nsovTTTJuRCVK9ijqfk/edit?usp=sharing).
+
+Overall Steps:
+
+It has sections for flow, we can then export to png for upload to Samsung
+
+## Samsung requirement
+
+Describe the application functionality in detail, by dividing it into clear use cases. The use cases must cover the main functions or scenarios of the application.
+
+You can use text, figures, and screenshots.
+
+Label each use case with a title.
+
+Create as many slides as you need.
+
+In addition to application-specific features, you must also describe any general user login, menu browsing, and in-app purchase features.
+
+Example:
+- From the home page, click the “Menu” key. The application menu appears.
+- Select “Explore” and click “OK”. The application moves to the “Explore” page, which shows a category list.
+- Select a category and click “OK”.  The application moves to the category page, which lists the videos in that category.
+- You can select a video for playback from the video list, or click “Back” to return to the category list.
+
+<p align="center">
+<img alt="Usecase example" src="https://developer.samsung.com/media/3296/userlogin_slide.png"/>
+</p>
+
+## Additional requirements
+
+| Application Feature | Required Information(missing information causes application rejection) | NOTES |
+| ------------------- | ---------------------------------------------------------------------- |------- |
+| User login | <ul><li>Test account with a valid user ID and password</li></ul> | [Demo link](https://demo.jellyfin.org/stable/web/#/login.html?serverid=713dc3fe952b438fa70ed35e4ef0525a&url=%2Fhome.html) user = demo - password is blank [Image Here](./Screenshots/Slide05.png)| 
+| Device activation | <ul><li>Test account that permits an unlimited number of activated devices</li><li>Instructions for activating the device at an external website, if needed</li></ul> |
+| In-app purchases | <ul><li>Valid credit card information for testing</li><li>Test account with funds available for making purchases</li><li>Valid coupon or promotional codes, if supported</li></ul> |
+| Gaming | <ul><li>Cheat codes or master account for accessing all game levels</li><li>List of correct responses to any trivia questions</li></ul> |
+| Smart View mobile integration	| <ul><li>Mobile application package attached to the TV application submission</li><li>Instructions for connecting the mobile application to the TV</li></ul> |
+| Geolocation or IP-restricted access | <ul><li>List of countries from which content can be accessed and permission to access the content through a VPN</li><li>Testing IP addresses added to allowed list</li></ul> |
+
+## Project Response Section
+
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide01.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide02.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide03.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide04.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide05.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide06.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide07.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide08.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide09.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide10.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide11.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide12.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide13.png"/></a>

App-Documentation-Samsung/docs/App-UI-Description/3-Menus-and-Functions/README.md

@@ -0,0 +1,65 @@
+# Menus and Functions
+
+## Colaborative workspace
+
+I have created a google slides [HERE](https://docs.google.com/presentation/d/1zBI6k_Lts2L2pui6vuNwfvy1AmN91xIo4W_2iDjCpds/edit?usp=sharing).
+
+It has sections for flow, we can then export to png for upload to Samsung
+
+## Samsung requirements
+
+Use labeled screenshots to describe the UI elements on each application screen.
+
+Create as many slides as you need.
+
+Label the UI elements with numbers or text. If there are many elements, use number labels.
+
+Describe the elements in a table.
+
+If the screenshots are not in English, provide translations for titles, headings, and button labels.
+
+<p align="center">
+<img alt="Usecase example" src="https://developer.samsung.com/media/3245/numberlabels_redesigned.png"/>
+</p>
+
+
+## Project Response Section
+
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide01.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide02.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide03.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide04.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide05.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide06.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide07.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide08.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide09.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide10.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide11.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide12.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide13.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide14.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide15.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide16.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide17.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide18.png"/></a>
+
+<img class="screenshot" alt="Translations" src="./Screenshots/Slide19.png"/></a>

App-Documentation-Samsung/docs/App-UI-Description/4-Remote-Control-Keys/README.md

@@ -0,0 +1,19 @@
+# Remote Control Keys
+
+* Up
+  * Navigate upward in the UI
+* Down
+  * Navigate downward in the UI
+  * During playback, show playback menu
+* Left
+  * Navigate left in the UI
+  * During playback, skip backward
+* Right
+  * Navigate right in the UI
+  * During playback, skip forward
+* Enter
+  * Select the current item
+  * Play / pause
+* Exit
+  * Navigate to the previous screen
+