The following requirements are only required if your App uses the specific integrations.
Kids section
Item
Requirement
Option 1a: Launching straight into a kids profile REQ_ID:KS01
Your App should open kid section deep links within kid profiles.
User Story
As a user I want to ensure that the kids section is a safe place for my kids to browse without being able to access inappropriate content through third party apps.
Pre-requisite
• SOIP
• The user is browsing the kids super section the X1 App Platform
• The user launches an app either via a deep link to kids content or from the Apps rail
• Kids profiles should only include content rated 0 or 6
Acceptance Criteria
When kids profiles have been created previously:
• GIVEN I am launching an app via a deep link from the kids section and have previously created a kids profile in the App WHEN the app launches THEN I should be taken straight to the show page (from no resume point)/ playback (from a resume point) within a kids profile that I have already created.
• GIVEN I am launching an app via a deep link from the kids section and have previously created multiple kids profiles in the App THEN I should be taken to the app profile screen to choose which profile I should watch from.
When no kids profiles have been created:
• GIVEN I am launching an app via a deep link from the kids section WHEN the app launches THEN I should be taken straight to the show page (from no resume point)/ playback (from a resume point) within a default kids profile
Example flows
Launching an App via a deep-link, into Kids profile with no profile set up:
Launching an App via a deep-link, into Kids profile with multiple profiles:
Launching an App via a direct app launch, into Kids profile with no profile set up:
Launching an App via a direct app launch, into Kids profile with multiple profiles:
Option 1b: Changing profiles REQ_ID:KS02
Your App should present a form of parental control before accessing an adult profile.
User Story
As a user I want to ensure that the kids section is a safe place for my kids to browse without being able to access inappropriate content through third party apps.
Pre-requisite
•SOIP
• The user launches an App either via a deep link to kids content or from the Apps rail
• The user tries to change profile from within the App
• Kids profiles should only include content rated 0 or 6
Acceptance Criteria
GIVEN that I’ve launched the App directly into a kids profile via the X1 App Platform Kids section WHEN I go to change profiles from within the App THEN I should have a form of parental controls challenges (e.g. pin challenge), before I can access an adult profile.
Option 2a: Launching via profile screen REQ_ID:KS03
Your App should open kid section deep links within kid profiles.
User Story
As a user I want to ensure that the kids section is a safe place for my kids to browse without being able to access inappropriate content through third party apps.
Pre-requisite
• SOIP
• The user is browsing the kids super section the X1 App Platform
• The user launches an app either via a deep link to kids content or from the Apps rail
• Kids profiles should only include content rated 0 or 6
Acceptance Criteria
When kids profiles have been created previously:
• GIVEN I am launching an app via a deep link from the kids section and have previously created a kids profile in the App WHEN the app launches THEN I should be taken straight to the show page (from no resume point)/ playback (from a resume point) within a kids profile that I have already created.
• GIVEN I am launching an App via a deep link from the kids section and have previously created multiple kids profiles in the App THEN I should be taken to the app profile screen to choose which profile I should watch from.
When no kids profiles have been created:
• GIVEN I am launching an app via a deep link from the kids section WHEN the App launches THEN I should be taken straight to the show page (from no resume point)/ playback (from a resume point) within a default kids profile
Example flows
Launching an App via a deep-link, profile screen before playback:
Launching an app via a direct App launch, profile screen before playback:
Option 2b: Launching via profile screen while App is in Background Active mode REQ_ID:KS04
Your App should take the user to the app profile screen or return to the kids profile when selecting a deep link from a kids section while the app is in Background Active mode.
User Story
As a user I want to ensure that the kids section is a safe place for my kids to browse without being able to access inappropriate content through third party apps.
Pre-requisite
• SOIP
• The user is browsing the kids super section of the X1 App Platform
• The app is already in Background Active mode (see Firebolt® Lifecycle States Requirements) from previous browsing
• The user launches an app either via a deep link to kids content or from the Apps rail
Acceptance Criteria
GIVEN I've left the app in Background Active mode as I browse the UI WHEN I select a deep-link for the same App from the kids section THEN I should either be taken to the app profile screen to choose which profile I should watch from OR I should be returned back to the Kids profile section.
Partner page
The partner page relies on the use of RSS feeds. For more information on integrating partner page RSS feeds visit the Partner Page RSS documentation.
Item
Requirement
Partner Page – Featured Rail REQ_ID:PP01
You must dictate which content should be displayed in your App's 'featured rail' within the X1 App Platform's Partner page UI.
User Story
As a user, I want to see an area dedicated to the content from a particular partner App.
Pre-requisite
• Partner has provided valid RSS feed
• The App metadata for each content asset in the feed, must have already been ingested.
Acceptance Criteria
• GIVEN I am on the X1 App Platform UI WHEN I go to a partner page THEN content in the featured rail should appear and deep-link into the App content
• GIVEN I am on the partner page WHEN I click on a content tile in the Featured rail THEN the App should launch to the correct content deep-link
Notes
• Content to be displayed in featured rail, is for the partner to dictate.
• Should avoid duplication with most popular rail.
• Currently, only individual content assets (shows) can appear in the rail
Partner page example
Partner Page – Most Popular Rail REQ_ID:PP02
You must dictate which content should be displayed in your App's 'most popular rail' within the X1 App Platform's Partner page UI.
User Story
As a user, I want to see an area dedicated to the content from a particular partner App.
Pre-requisite
• Partner has provided valid RSS feed
• The App metadata for each content asset in the feed, must have been already ingested.
Acceptance Criteria
• GIVEN I am on the X1 App Platform UI WHEN I go to a partner page THEN content in the most popular rail should appear and deep-link into the App content
• GIVEN I am on the partner page WHEN I click on a content tile in the most popular rail THEN the App should launch to the correct content deep-link.
Notes
• Content to be displayed in most popular rail is for the partner to dictate.
• Should avoid duplication with featured rail.
• Currently, only individual content assets (shows) can appear in the rail.
Advertising
Item
Requirement
Fast forwarding / scrubbing within an advertising break (ad break) REQ_ID:AT01
Users should be able to fast forward and scrub through ad breaks and resume playback as expected.
User Story
Pre-requisite
• User is in content.
Acceptance Criteria
GIVEN that a user has initiated FFWD and/or scrub forward in an ad break, THEN:
• the user should be taken through that ad break at an accelerated speed that matches up to the maximum FFWD and/or scrub forward speed supported by the player (minimum requirements listed below)
• the FFWD should persist, at the same speed, until the end of the ad-break or the user aborts FFWD.
• When FFWD through the ad-break completes, playback should resume in content with no black screens
• the FFWD should not pause or be interrupted by buffering or other visible transitions/ inconsistencies
GIVEN that a user has initiated FFWD and/or scrub forward in an ad break, WHEN the user play/resumes while in the ad break, THEN:
• playback of ad break should resume at 1x speed,
• playback should resume at an advanced position in the ad break that represents the progress the user made through FFWD.
• playback should NOT reset to the start of the ad-break
• there should be no abrupt changes in the UI or visual indicators that could confuse the user when switching back to normal playback (e.g., no large jumps in playhead position or countdown timer)
The player should support the same FFWD and/or Scrub Forward Requirements across content and ad breaks:
FFWD Experience
• GIVEN I am watching an ad break, WHEN I fast-forward, THEN the ad-break must fast-forward within 0.5 seconds.
• GIVEN I am watching an ad break, WHEN I fast-forward, THEN the ad break must fast-forward at the following multiple speeds x2, x6, x12, x30. (mirroring previous trickplay requirements).
Scrubbing Experience
• GIVEN I am watching an ad break, WHEN I move the audio track or video selector to a specific time, THEN the content must move to that point within 2 seconds.
Notes
• The ‘Ad Fast Forward Tier’ is indicated via Firebolt® Policy method within skipRestriction object.
• “none” is the equivalent for fast forward/scrubbing being allowed across content and ad breaks
Rewinding / scrubbing within an ad break REQ_ID:AT02
Users should be able to rewind and scrub through ad breaks and resume playback as expected.
User Story
Pre-requisite
• User is in content.
Acceptance Criteria
GIVEN that a user has initiated FFWD and/or scrub forward in content, WHEN the player comes across an ad break THEN:
• The FFWD should persist, at the same speed, across content and the ad break and back into content, or until the user aborts F FWD
• The FFWD should not pause or be interrupted by ad breaks
• The FFWD should not pause or be interrupted by buffering or other visible transitions/ inconsistencies
The player should support the same FFWD and/or Scrub Forward Requirement’s across content and ad breaks:
FFWD Experience
• GIVEN I am watching content, WHEN I fast-forward, THEN content and ad break(s) must fast-forward within 0.5 seconds.
• GIVEN I am watching content, WHEN I fast-forward, THEN content and ad break(s) must fast-forward at the following multiple speeds x2, x6, x12, x30. (mirroring previous trickplay requirements).
Scrubbing Experience
• GIVEN I am watching content, WHEN I move the audio track or video selector to a specific time, THEN the content must move to that point within 2 seconds.
Notes
• The ‘Ad Fast Forward Tier’ is indicated via Firebolt® Policy method within skipRestriction object.
• “none” is the equivalent for fast forward/scrubbing being allowed across content and ad breaks
Fast forwarding / scrubbing initiated in content and continues across mid-rolls REQ_ID:AT03
Users should be able to fast forward and scrub through ad breaks and resume playback as expected across mid-rolls.
User Story
Pre-requisite
• User is in content.
Acceptance Criteria
GIVEN that a user has initiated rewind and/or scrub back in an ad break, THEN:
• The user should be taken through that ad break at an accelerated speed that matches up to the maximum rewind speed and/or scr ub back speed supported by the player.
• Rewind should persist, at the same speed, until the end of the ad-break or the user aborts rewind.
• When rewinding through the ad-break has completed, playback in content should resume
• Rewind should not pause or be interrupted by buffering or other visible transitions/ inconsistencies
GIVEN that a user has initiated rewind and/or scrub back in an ad break, WHEN the user aborts rewind / hits play while in the ad break, THEN:
• playback of ad break should resume at 1x speed,
• playback should resume at an earlier position in the ad break that represents the progress the user made through rewinding d. there should be no abrupt changes in the UI or visual indicators that could confuse the user when switching back to normal playback (e.g., no large jumps in playhead position of countdown timer)
The player should support the same rewind KPI’s across content and ad breaks:
Rewind Experience
• GIVEN I am watching an ad break, WHEN I rewind, THEN the ad break must rewind within 0.5 seconds
• GIVEN I am watching an ad break, WHEN I rewind, THEN the ad break must rewind at the following multiple speeds x2, x6, x12, x30. (mirroring trickplay requirements).
Scrubbing Experience
• GIVEN I am watching an ad break, when I move the audio track or video selector to a specific time, THEN the content must move to that point within 2 seconds.
Notes
• The ‘Ad Fast Forward Tier’ is indicated via Firebolt® Policy method within skipRestriction object.
• “none” is the equivalent for fast forward/scrubbing being allowed across content and ad breaks
Rewinding initiated in content and continues across mid-rolls REQ_ID:AT04
Users should be able to rewind and scrub through ad breaks and resume playback as expected across mid-rolls.
User Story
Pre-requisite
• User is in content.
Acceptance Criteria
GIVEN that a user has initiated rewind and/or scrub back in content, THEN:
• Rewind should persist, at the same speed, across content and the ad break and back into content, or until the user aborts Rewind
• Rewind should not pause or be interrupted by ad breaks
• Rewind should not pause or be interrupted by buffering or other visible transitions/ inconsistencies
The player should support the same rewind requirements across content and ad breaks:
Rewind Experience
• GIVEN I am watching content, WHEN I rewind, THEN content and ad break(s) must rewind within 0.5 second.
• GIVEN I am watching content, WHEN I rewind, THEN content and ad break(s) must rewind at the following multiple speeds x2, x6, x12, x30. (mirroring previous trickplay requirements).
Scrubbing Experience
• GIVEN I am watching content, WHEN I move the audio track or video selector to a specific time, THEN the content must move to that point within 2 seconds.
Notes
• The ‘Ad Fast Forward Tier’ is indicated via Firebolt® policy method within skipRestriction object.
• “none” is the equivalent for rewind/scrubbing being allowed across content and ad breaks
Ad Trickplay UI / Visual Cues REQ_ID:AT05
Users should be presented with black screens, error screens, or any visible transitions when resuming from fast forward, rewind, or scrub state.
User Story
Acceptance Criteria
• GIVEN a user has initiated FFWD, rewind and/or scrub in an ad break, THEN:
a. black screens, error screens or other visible transitions/ inconsistencies should not be presented at any point during the FFWD, rewind, or scrub journey
b. Trickplay UI elements displayed should be consistent with the user interface for trickplay during content
c. Trickplay UI elements should display until the user aborts FFWD or rewind.
d. User should get a visual indication of progress in time via the Player UI elements, preferably with a countdown of time left in the ad-break and an updated timeline.
• GIVEN a user has initiated FFWD, rewind and/or scrub in an ad break, WHEN the user play/resumes while in the ad break, THEN Play/Resume should not display black screens, error screens or other visible transitions/ inconsistencies
• GIVEN that a user has not attempted trickplay / attempted to control playback in any way, THEN the Ad Trickplay UI should not be invoked
a. Note: This is to avoid the Trickplay UI displaying at the start of every ad-break in normal viewing mode and impacting the viewing experience.
Advert Quality REQ_ID:AT06
Advertisements should be in HD (high definition).
Exiting playback session after ad-break REQ_ID:AT07
User should be returned to playback at the same point they left without ad-breaks when resuming.
User Story
Pre-requisite
• User has fully watched an ad-break (Pre/Mid/Post roll) to 100% at 1x speed
• User has started watching content in App.
Acceptance Criteria
• WHEN the user exits the playback session AND THEN resumes playback (via Continue Watching / Selecting the same episode) THEN the user must return to playback at the exact same point they left AND no ad-break is served on resume.
Exiting playback session during ad-break REQ_ID:AT08
Playback must resume from the start of the ad-break when users exit playback session and then resumes playback.
User Story
Pre-requisite
• User is in an ad-break (Pre/Mid/Post roll).
Acceptance Criteria
• WHEN the user exits the playback session AND THEN resumes playback (via Continue Watching / Selecting the same episode) THEN playback resumes from the start of the ad-break again.
Separate Premium Ad Skip Experience supersedes Ad Tier entitlement REQ_ID:AT09
Users with entitlements to skip advertisements should have the ability to Trickplay ads.
User Story
Pre-requisite
• User is subscribed to the X1 App Platform over IP, and thus has a ‘Ad Tier’ or ‘Ad Fast Forward Tier’ entitlement assigned by the X1 App Platform
• User currently pays for an separate premium ad-skip / ad fast forwarding experience with the App itself, that is not part of an X1 App Platform entitlement.
Acceptance Criteria
• GIVEN that a user has initiated playback in App, And the user is subscribed to the X1 App Platform 'Ad Fast Forward Tier' THEN the user should be able to Trickplay Ads (FFWD, Scrub Ahead/back, Rewind Ads, Pause/Play) in the App.
• GIVEN that a user has initiated playback in App, And the user is subscribed to the X1 App Platform 'Ad Tier’ AND the user currently pays for a separate premium ad-skip / ad fast-forwarding experience with the App itself THEN the user should be able to Trickplay Ads (FFWD, Scrub Ahead/back, Rewind Ads, Pause/Play) in the App.
• Pause, Play, Rewind and Scrub Back actions must never be suppressed irrespective of Ad Tier entitlement.
Ad Trickplay Experience must match a user's Ad Tier entitlement REQ_ID:AT10
The ability to Trickplay ads should reflect the user's Ad Tier entitlement.
User Story
Pre-requisite
• User is subscribed to the X1 App Platform over IP, and thus has a ‘Ad Tier’ or ‘Ad Fast Forward Tier’ entitlement assigned by the X1 App Platform
• User does not currently pay for a separate premium ad-skip / ad fast forwarding experience with the App itself, that is independent of a X1 App Platform entitlement.
Acceptance Criteria
• GIVEN that a user has initiated playback in App, And the user is subscribed to the X1 App Platform 'Ad Fast Forward Tier' THEN the user should be able to Trickplay Ads (FFWD, Scrub Ahead/back, Rewind Ads, Pause/Play) in the App.
• GIVEN that a user has initiated playback in App, And the user is subscribed to the X1 App Platform 'Ad Tier' THEN the Fast Forward, and Scrub Ahead trickplay actions must be suppressed during Ad-breaks (subject to “Relax Viewing” requirement below ) AND playback of the Ad-break must continue at 1x Speed.
• Pause, Play, Rewind and Scrub Back actions must never be suppressed irrespective of Ad Tier entitlement.
No Trickplay restrictions during content playback REQ_ID:AT11
Trickplay should not be restricted over primary content playback.
User Story
Pre-requisite
• User is subscribed to 'Ad Tier'.
• User is watching primary content.
Acceptance Criteria
• Trick-play (FFWD / Rewind / high-speed scrub) should not be restricted over primary content playback.
• Trick-play should only be restricted over ad-break content.
Ad Markers for Non-FFWD REQ_ID:AT12
Ad markers should display in the playback bar and appear in the exact point which the Ad-break begins.
User Story
Pre-requisite
• User is subscribed to the ‘Ad Tier’ and has initiated playback in App.
Acceptance Criteria
• Ad markers should display in the seek bar / trickplay bar
• The Ad marker should appear at the precise point in playback ( in trickplay bar) where the Ad-break begins.
Notes
Ad Markers are spots/markings on the trickplay bar / seek bar that signal the presence of an ad break where trickplay is disabled.
"Relax View" for subsequent views of Ad-breaks REQ_ID:AT13
Users should be able to use trickplay on ads which have been previously viewed fully at 1x speed.
User Story
Pre-requisite
• User is subscribed to the 'Ad Tier' (i.e. Tier where Trickplay is suppressed on Ads)
• User has already viewed an ad break in full.
Acceptance Criteria
• GIVEN a user has fully watched an ad-break (Pre/Mid/Post roll) to 100% at 1x speed WHEN the user returns to the same ad-break position (by rewinding / scrubbing back to that position), THEN trickplay will not be restricted for this subsequent view SO THAT the user will be able to FFWD / high-speed scrub during this ad break on subsequent views.
UI Notifications for Trickplay supression REQ_ID:AT14
There should be a visible notification to indicate when Trickplay is not available and the user has attempted to use Trickplay.
User Story
Pre-requisite
• User is subscribed to the 'Ad Tier' where Trickplay on Ads is suppressed
• User is watching an Ad-break that he/she has not watched before (so Relax View is not in effect and the ad-break is not FFWD’able).
Acceptance Criteria
WHEN the user attempts to Trickplay (FFWD / high-speed scrub) out of this Ad-break, THEN:
• Trickplay (FFWD / high-speed scrub) should be suppressed and playback of the Ad-break must continue at 1x Speed
• A visual notification should display to the user, informing the user that Trickplay is suppressed, that playback will resume after the ad-break finishes, and how much time is left in the ad-break
• Notification should auto-dismiss so that it is not always on the screen.
High Speed scrub (jump) past multiple mid-rolls REQ_ID:AT15
Users must be presented with only the nearest mid-roll Ad-break position before resuming content from the jump/scrub point.
User Story
Pre-requisite
• User has started watching content in App
• The Content has 2 or more Mid-roll ad-breaks that the user has not yet viewed to 100%.
Acceptance Criteria
• WHEN the user attempts to Scrub Past / Jump Past 2 or more Mid-rolls ad breaks THEN the user must be pulled back to the Mid-roll position nearest to his/her jump position before playback resumes from the scrub/jump position
The user must watch this nearest Mid-roll Ad-break position before he/she can resume watching content from the jump/scrub point (i.e. the user must only watch one mid roll ad break nearest to their position rather than all Mid-rolls that they jumped across).
Unsubscribed Registered State REQ_ID:AT16
User should be able to Trickplay content and Ads according to your App's advertising product requirements.
User Story
Pre-requisite
• User was previously subscribed to the X1 App Platform, but has now cancelled their subscription and is now in an “unsubscribed registered state”.
Acceptance Criteria
• GIVEN that a user has initiated playback in App AND user is now in an “unsubscribed registered state” THEN the user should be able to Trickplay content and Ads according to the App’s own advertising product requirements.
Commerce Integration
Item
Requirement
Referral to commerce integration CTA REQ_ID:MP01
Non-subscribed users must be given a "Get via X1 App Platform" CTA to subscribe to the App from the sign-in / sign-up screen.
User Story
As a user, I want to be able to start a purchase journey of an App I am not signed into from the App landing page.
Acceptance Criteria
GIVEN I have not purchased an App subscription and I launch the App WHEN I am not logged into the App THEN while on the sign-in / sign-up screen, I must be given the option to select a “Get via X1 App Platform” CTA
Transition to commerce integration App for purchase REQ_ID:MP02
Users must be directed to the commerce integration App when they select the "Get via X1 App Platform" CTA.
User Story
As a user, I want to be redirected to the commerce integration App when I select the "Get via X1 App Platform" CTA.
Acceptance Criteria
• GIVEN I have launched the and I am presented with an option to ‘Get via X1 App Platform’ WHEN I select the ‘Get via X1 App Platform’ option THEN I must be redirected to the commerce integration App straight to a page with relevant information about the App subscription.
Notes
• Specification for the App to App transition (including the specific link parameters) will be provided separately. App will be responsible for sending the user to the specified link.
• X1 App Platform will be responsible for any content displayed within the commerce integration App.
Activation feedback REQ_ID:MP03
Your App must notify the X1 App Platform when a user has successfully purchased and activated a subscription to your App.
User Story
As a platform, I want to know if a user who has bought a subscription has successfully activated the subscription.
Acceptance Criteria
• GIVEN a user has bought a subscription to an App through the commerce integration WHEN the user activates that subscription with the App partner THEN X1 App platform should be notified of a successful activation.
Notes
Specification for how the activation notification should be passed to the X1 App Platform will be provided.
Silent Sign-In
Item
Requirement
On Product sign in - apps without existing account credentials REQ_ID:SI01
When a user signs into an app on one device, it should allow the user to auto sign into all other devices in their household.
User Story
As an app user, I want to sign into 3rd party apps across all my connected X1 App Platform devices, so that I don't have to repeat the time consuming process of signing-in on each device.
Pre-requisites
• The user is trying to sign into an app on any device
• The app the user is accessing supports silent sign in
• The user has multiple devices connected to the same account
Acceptance Criteria
• GIVEN I am signing in on product to Account X to 3rd party app that supports silent sign-in WHEN I've signed into the app then I should be eligible to auto sign in on other devices in my household.
• GIVEN I've signed in to a silent sign in supporting app on another device on my household WHEN I open the app on another device, that is not currently signed in, it should be signed in using the same account(s) as the device where I initiated silent sign in • Partner should show a notification in app to confirm the user has been signed in
On Product sign in - apps with existing account credentials REQ_ID:SI02
When a user signs into an app on one device, it should not overwrite existing credentials on other devices in their household.
User Story
As an app user, I don't want silent sign in to overwrite existing account credentials that are being used on additional devices
Pre-requisites
• The user is trying to sign into an app on any device
• The app the user is access supports silent sign in
• The user has multiple devices connected to the same account
• The user has already signed into an app on one of their devices
Acceptance Criteria
• GIVEN I am signing in on product to Account X to 3rd party app that supports silent sign-in WHEN I open the app on another device, that is signed in to a different account, THEN the app will remain signed in with the local credentials and will not be signed in to the new account
• GIVEN I am signing in on product to Account X to 3rd party app that supports silent sign-in WHEN I open the app on another device, that is signed in to the same account THEN the app will remain signed in with the local credentials
Silent sign in following signing out from previous credentials on additional devices REQ_ID:SI03
Users should be able to use silent sign in after signing out on other devices.
User Story
As an app user, I want silent sign in to auto sign me into an app with my silent sign in credentials if I sign out of any existing accounts on other devices.
Pre-requisites
• The user is trying to sign into an app on any device
• The app the user is accessing supports silent sign in
• The user has multiple devices connected to the same account
• The user has opted in to silent sign in on a device but at the time was signed in to the app with another account on another device
• The user is signing out of the alterative credentials either on platform or through the partner's website
Acceptance Criteria
• GIVEN that I've signed out of my existing account on a secondary device WHEN I next launch the app THEN it should be signed in using the same account as the device where I initiated silent sign in
• Partner should show a notification in app to confirm the user has been signed in
Notes
If the app was previously signed in with the same account as the silent sign in credentials then when they relaunch the app it will be signed in again with the same account but using the authentication token from silent sign in
Sign in to 3rd party apps through commerce integration REQ_ID:SI04
Users using commerce integration should have their credentials available for auto sign in after creating an account. You must present a clear message to indicate all devices will be auto signed in using the provided account information.
User Story
As a user buying through X1 App Platform commerce integration, I want my account credentials provided at account creation to auto sign me into the app across all my devices
Pre-requisites
• The app the user is accessing supports silent sign in
• The user has purchased the app through commerce integration
• The user has gone through the account creation process on the partner's website
Acceptance Criteria
•GIVEN I have purchased an app through the commerce integration THEN there should be clear messaging to indicate that all devices will be auto signed in using my new account credentials before I leave the journey to create my partner account
• Given that I have created account credentials through the commerce integration journey with an app that supports silent sign in WHEN I have completed account creation THEN those credentials should be available to auto sign into my X1 App Platform devices
• GIVEN I have created an account through commerce integration, WHEN I launch that app on an X1 App Platform device, THEN I should be automatically signed into the commerce integration account (Account X).
• Partner should show a notification in app to confirm the user has been signed in
Notes
A similar approach will be required to support an off platform pre-authentication journey in the future
Sharing device friendly names with partner sign out journey (optional behavior) REQ_ID:SI05
Users should be presented with device friendly names when signing out of a device through your App's website.
User Story
As a user when I choose to log out of a device from a partner's website I want the device friendly names that I've chosen for devices to appear in the list of active devices.
Pre-requisites
• The app the user is accessing supports silent sign in
• The user has selected device friendly names for their devices
• The user is on the partner's website attempting to log out
• The partner's website supports logging out of individual devices
Acceptance Criteria
• GIVEN I have set up device friendly names for my panel/puck when I attempt to log out from a third party website THEN the device friendly name for my devices should appear in the list
• Only the devices where a user is logged into the partner app should be available
Notes
Not all partners will allow log out from their website. This requirement is only for apps that do and the X1 App Platform will need to support this journey.
Sign out of 3rd party apps on devices within the product REQ_ID:SI06
Users which sign out of a 3rd party app on one device should only be signed out of the app on that device. Other devices should not be affected.
User Story
As an app user, when I sign out of an app I want the sign out to only impact the local device
Pre-requisites
• The app the user is accessing supports silent sign in
• The user has multiple devices connected to the same account
• The user has used silent sign in to authenticate on this device
• The user is signing out of the alternative credentials either on the X1 App Platform or through the partner's website
Acceptance Criteria
• GIVEN I have signed-in with Account X to a 3rd party app WHEN I sign out of the app THEN I should only be signed out of the device I am on. Other devices should not be affected.
• GIVEN I have signed out with Account X on a 3rd party app WHEN i relaunch the app THEN I should be presented with a sign-in screen.
Sign out of 3rd party apps across all devices - With subscription token (commerce integration) REQ_ID:SI07
Users which sign out of a 3rd party app on one device should only be signed out of the app on that device. Other devices should not be affected and the X1 App Platform will retain the subscription token.
User Story
As an app user that has purchased a subscription through commerce integration, when I sign out of an app I want the sign out to only impact the local device
Pre-requisites
• The app the user is accessing supports silent sign in
• The user has multiple devices connected to the same account
• The user has used silent sign in to authenticate on this device
• The user is signing out of the alternative credentials either on platform or through the partner's website
• The user has purchased the app subscription through commerce integration
Acceptance Criteria
• GIVEN I have signed-in with Account X to a 3rd party app WHEN I sign out of the app THEN I should only be signed out of the device I am on. Other devices should not be affected.
• GIVEN I have signed out with Account X on a 3rd party app WHEN I relaunch the app THEN I should be presented with a sign-in screen offering two options:
1. Sign-in with retained subscription details - as subscription token has been retained
2. An alternative method to sign in using different details (QR code, keyboard sign-in, pin pairing etc)
Notes
The X1 App Platform will retain the subscription token and therefore will retain sign-in details for users.
Sign out of 3rd party apps on all devices off product (optional behavior) REQ_ID:SI08
Users which use your App's website to "sign out of all devices" should be signed out of all devices that they are logged into and the authentication token should be cancelled.
User Story
As an app user, when I go to the partner website of an app I want to be able to sign out of all my devices (including all devices)
Pre-requisites
• The app the user is accessing supports silent sign in
• The user has multiple devices connected to the same account
• The user has opted in to silent sign in previously and those credentials are used on this device
• The user is signing out of the account through the partner's website
Acceptance Criteria
GIVEN I have signed-in with Account X to a 3rd party app WHEN I click ‘sign out of all devices’ on the partner website THEN I should be signed out of all my devices I am logged in on and the authentication token should be cancelled • The authentication token should be cancelled and no longer eligible for auto sign in
Notes
Not all partners will allow log out from their website. This requirement is only for apps that do and the X1 App Platform will need to support this journey.
Sign out of 3rd party apps on individual devices (optional behavior). REQ_ID:SI09
Users which use your App's website to "sign out of friendly device name" should only be signed out on the device that they selected to log out of.
User Story
As an app user, when I go to the partner website of an app I want to be able to sign out of each individual device (including all individual devices)
Pre-requisites
• The app the user is accessing supports silent sign in
• The user has multiple devices connected to the same account
• The user has opted in to silent sign in previously and those credentials are used on this device
• The user is signing out of the account through the partner's website
Acceptance Criteria
GIVEN I have signed-in with Account X to a 3rd party app WHEN I sign out of a particular device on the partner website THEN I should only be signed out of the device I have selected. Other devices should not be affected but then authentication token should be cancelled.
Notes
Not all partners will allow log out from their website. This requirement is only for apps that do and the X1 App Platform will need to support this journey.
Entitlement
Item
Requirement
Signed-In / Authentication Status REQ_ID:EN01
Your App should inform the X1 App Platform when a user has successfully signed-in and signed-out.
User Story
Pre-requisites
• The App requires a user to sign-in in order to access & playback content.
Acceptance Criteria
• GIVEN a user has signed-in to the App, THEN the App should inform the X1 App Platform with a successful sign-in response, login token and specified endTime
• GIVEN a user is signed-in to the App WHEN the user launches the , THEN the App should update the sign-in response, login token and specified endTime
• GIVEN a user has signed-out of the App, THEN the App should inform the X1 App Platform of a sign-out response.
Entitlement Status REQ_ID:EN02
Your App should inform the X1 App Platform when a user has modified their subscription for your App.
User Story
Pre-requisites
• The App requires an account / subscription in order to access & playback content.
Acceptance Criteria
• GIVEN a user has purchased / changed / upgraded / downgraded a subscription for the App, THEN the App should update the X1 App Platform with a new Discovey.contentAccess(entitlements) API call.
• GIVEN a user has launched the App, THEN the App should refresh and update the X1 App Platform with any new changes.
• GIVEN a user has cancelled their subscription for the App, THEN the App should update the X1 App Platform with a new Discovery.contentAccess(entitlements) API call, AND when the specified endTime has lapsed, THEN the App should clear and remove all entitlements for the user with a Discovery.clearContentAccess API Call.
Thumbnail Trickplay recommendations
Item
Requirement
Enabling Thumbnail Trickplay REQ_ID:TH01
• Users should be able to trigger thumbnail Trickplay from the D-Pad on the remote without navigating to any in-App button on the progress bar. • Users should be able to start fast-forwarding / rewinding with a single click on the D-Pad, with each click increasing the FFWD / RWND speed. • Users should should be able to stop thumbnail Trickplay and resume / pause playback by either pressing the Select button the D-Pad or using the Play/Pause button on the remote.
Thumbnail Trickplay Speeds REQ_ID:TH02
Users should be able to fast-forward or rewind content at three incremental speeds.
Thumbnail Trickplay UI REQ_ID:TH03
• The progress bar should remain at the point where Trickplay was initiated; and should remain visible during Trickplay. • A minimum of 3 thumbnails should display when the user is fast-forwarding / rewinding / scrubbing.
Was this article helpful?
Thank you for your feedback! Our team will get back to you