octane-0.16.2: library/Octane/Type/Replay.hs
{-# LANGUAGE DataKinds #-}
{-# LANGUAGE DeriveGeneric #-}
{-# LANGUAGE FlexibleContexts #-}
{-# LANGUAGE FlexibleInstances #-}
{-# LANGUAGE MultiParamTypeClasses #-}
{-# LANGUAGE OverloadedLabels #-}
{-# LANGUAGE OverloadedStrings #-}
{-# LANGUAGE StrictData #-}
{-# LANGUAGE TemplateHaskell #-}
{-# LANGUAGE TypeFamilies #-}
module Octane.Type.Replay
( Replay(..)
, fromOptimizedReplay
, toOptimizedReplay
) where
import Data.Aeson ((.=))
import Data.Function ((&))
import qualified Control.DeepSeq as DeepSeq
import qualified Data.Aeson as Aeson
import qualified Data.Binary as Binary
import qualified Data.Default.Class as Default
import qualified Data.Map.Strict as Map
import qualified Data.Maybe as Maybe
import qualified Data.OverloadedRecords.TH as OverloadedRecords
import qualified Data.Set as Set
import qualified Data.Text as StrictText
import qualified Data.Tuple as Tuple
import qualified Data.Version as Version
import qualified GHC.Generics as Generics
import qualified Octane.Data as Data
import qualified Octane.Type.CacheItem as CacheItem
import qualified Octane.Type.CacheProperty as CacheProperty
import qualified Octane.Type.ClassItem as ClassItem
import qualified Octane.Type.Dictionary as Dictionary
import qualified Octane.Type.Frame as Frame
import qualified Octane.Type.KeyFrame as KeyFrame
import qualified Octane.Type.List as List
import qualified Octane.Type.Mark as Mark
import qualified Octane.Type.Message as Message
import qualified Octane.Type.OptimizedReplay as OptimizedReplay
import qualified Octane.Type.Property as Property
import qualified Octane.Type.Text as Text
import qualified Octane.Type.Word32 as Word32
-- | A fully-processed, optimized replay. This is the nicest format for humans
-- to work with. It can be converted all the way back down to a
-- 'Octane.Type.RawReplay.RawReplay' for serialization.
data Replay = Replay
{ replayVersion :: Version.Version
, replayMetadata :: Map.Map StrictText.Text Property.Property
-- ^ High-level metadata about the replay. Only one key is actually
-- required to be able to view the replay in Rocket League:
--
-- - MapName: This is a 'Property.NameProperty'. It is a case-insensitive
-- map identifier, like @"Stadium_P"@.
--
-- There are many other properties that affect how the replay looks in the
-- list of replays in Rocket League:
--
-- - Date: A 'Property.StrProperty' with the format @"YYYY-mm-dd:HH-MM"@.
-- Dates are not validated, but the month must be between 1 and 12 to
-- show up. The hour is shown modulo 12 with AM or PM.
--
-- - MatchType: A 'Property.NameProperty'. If this is not one of the
-- expected values, nothing will be shown next to the replay's map. The
-- expected values are: @"Online"@, @"Offline"@, @"Private"@, and
-- @"Season"@.
--
-- - NumFrames: This 'Property.IntProperty' is used to calculate the length
-- of the match. There are 30 frames per second, meaning @9000@ frames is
-- a 5-minute match.
--
-- - PrimaryPlayerTeam: This is an 'Property.IntProperty'. It is either 0
-- (blue) or 1 (orange). Any other value is ignored. If this would be 0,
-- you don't have to set it at all.
--
-- - ReplayName: An optional 'Property.StrProperty' with a user-supplied
-- name for the replay.
--
-- - Team0Score: The blue team's score as an 'Property.IntProperty'. Can be
-- omitted if the score is 0.
--
-- - Team1Score: The orange team's score as an 'Property.IntProperty'. Can
-- also be omitted if the score is 0.
--
-- - TeamSize: An 'Property.IntProperty' with the number of players per
-- team. This value is not validated, so you can put absurd values like
-- @99@. To get an "unfair" team size like 1v4, you must set the
-- @"bUnfairBots"@ 'Property.BoolProperty' to @True@.
, replayLevels :: [StrictText.Text]
, replayMessages :: Map.Map StrictText.Text StrictText.Text
, replayTickMarks :: Map.Map StrictText.Text StrictText.Text
, replayPackages :: [StrictText.Text]
, replayFrames :: [Frame.Frame]
} deriving (Eq, Generics.Generic, Show)
$(OverloadedRecords.overloadedRecord Default.def ''Replay)
instance Binary.Binary Replay where
get = do
optimizedReplay <- Binary.get
fromOptimizedReplay optimizedReplay
put replay = do
optimizedReplay <- toOptimizedReplay replay
Binary.put optimizedReplay
instance DeepSeq.NFData Replay
instance Aeson.ToJSON Replay where
toJSON replay =
Aeson.object
[ "Version" .= #version replay
, "Metadata" .= #metadata replay
, "Levels" .= #levels replay
, "Messages" .= #messages replay
, "TickMarks" .= #tickMarks replay
, "Packages" .= #packages replay
, "Frames" .= #frames replay
]
-- | Converts an 'OptimizedReplay.OptimizedReplay' into a 'Replay'.
-- Operates in a 'Monad' so that it can 'fail' somewhat gracefully.
fromOptimizedReplay
:: (Monad m)
=> OptimizedReplay.OptimizedReplay -> m Replay
fromOptimizedReplay optimizedReplay = do
pure
Replay
{ replayVersion =
[#version1 optimizedReplay, #version2 optimizedReplay] &
map Word32.fromWord32 &
Version.makeVersion
, replayMetadata =
optimizedReplay & #properties & #unpack & Map.mapKeys #unpack
, replayLevels = optimizedReplay & #levels & #unpack & map #unpack
, replayMessages =
optimizedReplay & #messages & #unpack &
map
(\message -> do
let key = message & #frame & #unpack & show & StrictText.pack
let value = message & #content & #unpack
(key, value)) &
Map.fromList
, replayTickMarks =
optimizedReplay & #marks & #unpack &
map
(\mark -> do
let key = mark & #frame & #unpack & show & StrictText.pack
let value = mark & #label & #unpack
(key, value)) &
Map.fromList
, replayPackages = optimizedReplay & #packages & #unpack & map #unpack
, replayFrames = optimizedReplay & #frames
}
-- | Converts a 'Replay' into an 'OptimizedReplay.OptimizedReplay'.
-- Operates in a 'Monad' so that it can 'fail' somewhat gracefully.
toOptimizedReplay
:: (Monad m)
=> Replay -> m OptimizedReplay.OptimizedReplay
toOptimizedReplay replay
-- Key frames aren't important for replays. Mark the first frame as a key
-- frame and the rest as regular frames.
= do
let frames =
replay & #frames & zip [0 :: Int ..] &
map (\(index, frame) -> frame {Frame.frameIsKeyFrame = index == 0})
-- The actors are a list of all classes, objects, and properties used in the
-- replay. An actor's position in this list is their ID, not their stream ID.
let classNames =
frames & concatMap #replications & map #className & ("Core.Object" :) &
Set.fromList
let objectNames =
frames & concatMap #replications & map #objectName & Set.fromList
let propertyNames =
frames & concatMap #replications & map #properties & concatMap Map.keys &
Set.fromList
let actors =
classNames & Set.union objectNames & Set.union propertyNames &
Set.toAscList &
map Text.Text &
List.List
-- The class items are a list of class names to their stream IDs.
let classItems =
classNames & Set.toAscList & map Text.Text & zip [0 ..] &
map (\(streamId, name) -> do ClassItem.ClassItem name streamId) &
List.List
-- The cache items are a list of classes together with their cache IDs,
-- parent cache IDs, and a list of their property IDs to stream IDs.
let classesToId =
classItems & #unpack & map (\x -> (#name x, #streamId x)) & Map.fromList
let actorsToId = actors & #unpack & zip [0 ..] & map Tuple.swap & Map.fromList
let propertiesByClass =
frames & concatMap #replications &
concatMap
(\replication ->
zip
(replication & #className & Text.Text & repeat)
(replication & #properties & Map.keys & map Text.Text)) &
Set.fromList &
Set.toAscList &
zip [0 ..] &
map
(\(streamId, (className, propertyName)) -> do
let propertyId =
actorsToId & Map.lookup propertyName & Maybe.fromJust
let cacheProperty = CacheProperty.CacheProperty propertyId streamId
let cacheProperties = [cacheProperty]
(className, cacheProperties)) &
Map.fromListWith (++)
let cacheItems =
classItems & #unpack & zip [0 ..] &
map
(\(cacheId, classItem) -> do
let className = #name classItem
let classId = classesToId & Map.lookup className & Maybe.fromJust
let parentCacheId = 0 -- cacheId
let properties =
propertiesByClass & Map.findWithDefault [] className &
List.List
CacheItem.CacheItem classId parentCacheId cacheId properties) &
List.List
pure
OptimizedReplay.OptimizedReplay
{ OptimizedReplay.optimizedReplayVersion1 = Data.latestMajorVersion
, OptimizedReplay.optimizedReplayVersion2 = Data.latestMinorVersion
, OptimizedReplay.optimizedReplayLabel = "TAGame.Replay_Soccar_TA"
, OptimizedReplay.optimizedReplayProperties =
replay & #metadata & Map.mapKeys Text.Text & Dictionary.Dictionary
, OptimizedReplay.optimizedReplayLevels =
replay & #levels & map Text.Text & List.List
, OptimizedReplay.optimizedReplayKeyFrames =
frames & filter #isKeyFrame &
map
(\frame ->
KeyFrame.KeyFrame
(#time frame)
(frame & #number & Word32.toWord32)
0) &
List.List
, OptimizedReplay.optimizedReplayFrames = frames
, OptimizedReplay.optimizedReplayMessages =
replay & #messages & Map.toList &
map
(\(key, value) -> do
let frame = key & StrictText.unpack & read & Word32.Word32
let content = value & Text.Text
Message.Message frame "" content) &
List.List
, OptimizedReplay.optimizedReplayMarks =
replay & #tickMarks & Map.toList &
map
(\(key, value) -> do
let label = value & Text.Text
let frame = key & StrictText.unpack & read & Word32.Word32
Mark.Mark label frame) &
List.List
, OptimizedReplay.optimizedReplayPackages =
replay & #packages & map Text.Text & List.List
, OptimizedReplay.optimizedReplayObjects = actors
, OptimizedReplay.optimizedReplayNames = List.List [] -- TODO
, OptimizedReplay.optimizedReplayClasses = classItems
, OptimizedReplay.optimizedReplayCache = cacheItems
}