PVRChannelGroup.h

/*
 *  Copyright (C) 2012-2018 Team Kodi
 *  This file is part of Kodi - https://kodi.tv
 *
 *  SPDX-License-Identifier: GPL-2.0-or-later
 *  See LICENSES/README.md for more information.
 */

#pragma once

#include "pvr/channels/PVRChannelGroupSettings.h"
#include "pvr/channels/PVRChannelNumber.h"
#include "pvr/channels/PVRChannelsPath.h"
#include "utils/EventStream.h"

#include <map>
#include <memory>
#include <string>
#include <utility>
#include <vector>

struct PVR_CHANNEL_GROUP;

namespace PVR
{
#define PVR_GROUP_TYPE_DEFAULT 0
#define PVR_GROUP_TYPE_INTERNAL 1
#define PVR_GROUP_TYPE_USER_DEFINED 2

enum class PVREvent;

class CPVRChannel;
class CPVRChannelGroupMember;
class CPVRClient;
class CPVREpgInfoTag;

enum RenumberMode
{
  NORMAL = 0,
  IGNORE_NUMBERING_FROM_ONE = 1
};

using GroupMemberPair =
    std::pair<std::shared_ptr<CPVRChannelGroupMember>, std::shared_ptr<CPVRChannelGroupMember>>;

class CPVRChannelGroup : public IChannelGroupSettingsCallback
{
  friend class CPVRDatabase;

public:
  static const int INVALID_GROUP_ID = -1;

  CPVRChannelGroup(const CPVRChannelsPath& path,
                   const std::shared_ptr<CPVRChannelGroup>& allChannelsGroup);

  CPVRChannelGroup(const PVR_CHANNEL_GROUP& group,
                   const std::shared_ptr<CPVRChannelGroup>& allChannelsGroup);

  ~CPVRChannelGroup() override;

  bool operator==(const CPVRChannelGroup& right) const;
  bool operator!=(const CPVRChannelGroup& right) const;

  void FillAddonData(PVR_CHANNEL_GROUP& group) const;

  CEventStream<PVREvent>& Events() { return m_events; }

  virtual bool LoadFromDatabase(
      const std::map<std::pair<int, int>, std::shared_ptr<CPVRChannel>>& channels,
      const std::vector<std::shared_ptr<CPVRClient>>& clients);

  virtual void Unload();

  size_t Size() const;

  virtual bool UpdateFromClients(const std::vector<std::shared_ptr<CPVRClient>>& clients);

  const CPVRChannelsPath& GetPath() const;

  void SetPath(const CPVRChannelsPath& path);

  bool SetChannelNumber(const std::shared_ptr<CPVRChannel>& channel,
                        const CPVRChannelNumber& channelNumber);

  virtual bool RemoveFromGroup(const std::shared_ptr<CPVRChannel>& channel);

  virtual bool AppendToGroup(const std::shared_ptr<CPVRChannel>& channel);

  void SetGroupName(const std::string& strGroupName);

  bool Persist();

  virtual bool IsGroupMember(const std::shared_ptr<CPVRChannel>& channel) const;

  bool IsInternalGroup() const { return m_iGroupType == PVR_GROUP_TYPE_INTERNAL; }

  bool IsRadio() const;

  int GroupID() const;

  void SetGroupID(int iGroupId);

  void SetGroupType(int iGroupType);

  int GroupType() const;

  time_t LastWatched() const;

  void SetLastWatched(time_t iLastWatched);

  uint64_t LastOpened() const;

  void SetLastOpened(uint64_t iLastOpened);

  std::string GroupName() const;


  void Sort();

  bool SortAndRenumber();

  bool Renumber(RenumberMode mode = NORMAL);


  // IChannelGroupSettingsCallback implementation
  void UseBackendChannelOrderChanged() override;
  void UseBackendChannelNumbersChanged() override;
  void StartGroupChannelNumbersFromOneChanged() override;

  std::shared_ptr<CPVRChannelGroupMember> GetLastPlayedChannelGroupMember(
      int iCurrentChannel = -1) const;

  GroupMemberPair GetLastAndPreviousToLastPlayedChannelGroupMember() const;

  std::shared_ptr<CPVRChannelGroupMember> GetByChannelNumber(
      const CPVRChannelNumber& channelNumber) const;

  CPVRChannelNumber GetChannelNumber(const std::shared_ptr<CPVRChannel>& channel) const;

  CPVRChannelNumber GetClientChannelNumber(const std::shared_ptr<CPVRChannel>& channel) const;

  std::shared_ptr<CPVRChannelGroupMember> GetNextChannelGroupMember(
      const std::shared_ptr<CPVRChannelGroupMember>& groupMember) const;

  std::shared_ptr<CPVRChannelGroupMember> GetPreviousChannelGroupMember(
      const std::shared_ptr<CPVRChannelGroupMember>& groupMember) const;

  std::shared_ptr<CPVRChannel> GetByChannelID(int iChannelID) const;

  enum class Include
  {
    ALL,
    ONLY_HIDDEN,
    ONLY_VISIBLE
  };

  std::vector<std::shared_ptr<CPVRChannelGroupMember>> GetMembers(
      Include eFilter = Include::ALL) const;

  void GetChannelNumbers(std::vector<std::string>& channelNumbers) const;

  virtual size_t GetNumHiddenChannels() const { return 0; }

  bool HasChannels() const;

  bool HasNewChannels() const;

  bool HasChanges() const;

  bool IsNew() const;

  virtual bool CreateChannelEpgs(bool bForce = false);

  bool UpdateChannel(const std::pair<int, int>& storageId,
                     const std::string& strChannelName,
                     const std::string& strIconPath,
                     int iEPGSource,
                     int iChannelNumber,
                     bool bHidden,
                     bool bEPGEnabled,
                     bool bParentalLocked,
                     bool bUserSetIcon,
                     bool bUserSetHidden);

  std::shared_ptr<CPVRChannel> GetByUniqueID(int iUniqueChannelId, int iClientID) const;

  std::shared_ptr<CPVRChannelGroupMember> GetByUniqueID(const std::pair<int, int>& id) const;

  bool SetHidden(bool bHidden);
  bool IsHidden() const;

  int GetPosition() const;
  void SetPosition(int iPosition);

  bool HasValidDataForClient(int iClientId) const;

  bool HasValidDataForClients(const std::vector<std::shared_ptr<CPVRClient>>& clients) const;

  bool UpdateChannelNumbersFromAllChannelsGroup();

  void Delete();

  bool IsDeleted() const { return m_bDeleted; }

  int CleanupCachedImages();

protected:
  virtual std::vector<std::shared_ptr<CPVRChannelGroupMember>> RemoveDeletedGroupMembers(
      const std::vector<std::shared_ptr<CPVRChannelGroupMember>>& groupMembers);

  bool UpdateGroupEntries(const std::vector<std::shared_ptr<CPVRChannelGroupMember>>& groupMembers);

  void SortByClientChannelNumber();

  void SortByChannelNumber();

  bool UpdateClientPriorities();

  std::shared_ptr<CPVRChannelGroupSettings> GetSettings() const;

  int m_iGroupType = PVR_GROUP_TYPE_DEFAULT; 
  int m_iGroupId = INVALID_GROUP_ID; 
  bool m_bLoaded = false; 
  bool m_bChanged =
      false; 
  time_t m_iLastWatched = 0; 
  uint64_t m_iLastOpened = 0; 
  bool m_bHidden = false; 
  int m_iPosition = 0; 
  std::vector<std::shared_ptr<CPVRChannelGroupMember>>
      m_sortedMembers; 
  std::map<std::pair<int, int>, std::shared_ptr<CPVRChannelGroupMember>>
      m_members; 
  mutable CCriticalSection m_critSection;
  std::vector<int> m_failedClients;
  CEventSource<PVREvent> m_events;
  mutable std::shared_ptr<CPVRChannelGroupSettings> m_settings;

  // the settings singleton shared between all group instances
  static CCriticalSection m_settingsSingletonCritSection;
  static std::weak_ptr<CPVRChannelGroupSettings> m_settingsSingleton;

private:
  int LoadFromDatabase(const std::vector<std::shared_ptr<CPVRClient>>& clients);

  void DeleteGroupMembersFromDb(
      const std::vector<std::shared_ptr<CPVRChannelGroupMember>>& membersToDelete);

  bool UpdateFromClient(const std::shared_ptr<CPVRChannelGroupMember>& groupMember);

  bool AddAndUpdateGroupMembers(
      const std::vector<std::shared_ptr<CPVRChannelGroupMember>>& groupMembers);

  void OnSettingChanged();

  std::shared_ptr<CPVRChannelGroup> m_allChannelsGroup;
  CPVRChannelsPath m_path;
  bool m_bDeleted = false;
};
} // namespace PVR