Skip to end of banner
Go to start of banner

Local channels

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Version History

« Previous Version 4 Next »

Introduction

In the Netherlands there are local television channels that need to be made available to people living within a particular locality.

Operators are required to:

  1. Make local channels available to local residents
  2. Ensure that local channels from other areas are not available


Amino implementation

Amino models local channels by including a boolean flag that indicates whether the channel is local or not.

Users are licensed by the customer to view particular local channels;  Amino does not store information about where the user lives and cannot determine what channels they need to be able to view.

Therefore, when displaying a list of local channels to a user, the client should:

  1. Obtain a general list of channels and find the ones which are local by examining the flag
  2. Filter out channels from this list that the user does not have a license for

In practice

Using legacy endpoints to display a list of local channels

Our legacy endpoint does step 1 and 2 together on behalf of the client;  It is documented at Channel#/Channel/indexUserSpecificChannels

If a channel appears in this list then the user is allowed to watch it.

There may be a further requirement from the customer that local channels appear with a sequential lcn.   Amino does not guarantee that local channels will be ordered as such in the API output and the client may need to perform further processing in order to meet customer requirements.

Using REST based endpoints to display a list of local channels

This is a special case of the more general approach described in detail on the page for the /wiki/spaces/MAPI/pages/49676405.

Step 1 - Obtain a list of channels

Fetch an index of the Channel resource.  This API is documented at Metadata: Channels#/Channels/GetChannelIndex

Note that this endpoint is not filtered for the individual user in order to make it publicly cacheable and reduce load on the API.

Step 2 - Filter out channels

The frontend should filter out channels by removing:

  • Channels whose availability window does not include the current time
    • See Channel.availability_window.time_limited_event
    • If this field is true then compare the current time to the "not before" and "not after" definitions
  • Demo channels, unless the user is a demo user
  • Channels that are geo-blocked for the user
  • Channels that do not have the local flag

This is documented in detail here and only the last bullet point is different from the general approach to managing channels.

Step 3 - Obtain the user licenses

Fetch the channel licenses that are related to a user by calling the API documented at License

Step 4 - Remove channels that the user has no license for

Please see the documentation on Channels at /wiki/spaces/MAPI/pages/49676405


  • No labels