Update documentation for the pillarbox-player module

[MGaetan89]

Pull request

Description

This updates the KDoc for every public API in the pillarbox-player module.

Changes made

• Update documentation in pillarbox-player.
• Add a missing case in StringUtil. discontinuityReasonString() (only actual code change 45be0ac).
• Fix references to the build.yml workflow, following the merge of Update GitHub Actions workflows #818.

Checklist

• APIs have been properly documented (if relevant).
• The documentation has been updated (if relevant).
• New unit tests have been written (if relevant).
• The demo has been updated (if relevant).

[github-actions]

Code Coverage

Overall Project	48.66%	🟢
Files changed	100%	🟢

Module	Coverage
:pillarbox-player	56.59%	🟢

Files

Module	File	Coverage
:pillarbox-player	MediaItemTrackerData.kt	100%	🟢
	PillarboxTrackSelector.kt	100%	🟢
	PillarboxBandwidthMeter.kt	100%	🟢
	PillarboxRenderersFactory.kt	100%	🟢
	BlockedTimeRange.kt	100%	🟢
	Format.kt	100%	🟢
	VideoSize.kt	100%	🟢
	PlayerCommands.kt	100%	🟢
	AssetLoader.kt	100%	🟢
	Asset.kt	100%	🟢
	TracksExtensions.kt	100%	🟢
	PendingIntentUtils.kt	100%	🟢
	StringUtil.kt	100%	🟢
	Heartbeat.kt	98.52%	🟢
	MediaMetadata.kt	98.41%	🟢
	PillarboxOkHttp.kt	97.56%	🟢
	PlaybackMetrics.kt	97.47%	🟢
	Track.kt	93.83%	🟢
	Tracks.kt	93.67%	🟢
	PlaybackSessionManager.kt	93.03%	🟢
	PillarboxMediaDescriptionAdapter.kt	92.89%	🟢
	PillarboxMediaSource.kt	87.35%	🟢
	PillarboxPreloadManager.kt	85.88%	🟢
	TotalPlaytimeCounter.kt	85.71%	🟢
	UrlAssetLoader.kt	80.65%	🟢
	PillarboxBuilder.kt	78.55%	🟢
	PillarboxLoadControl.kt	78.38%	🟢
	TimeRange.kt	78.38%	🟢
	EventMessageData.kt	77.29%	🟢
	Message.kt	76.03%	🟢
	PillarboxExoPlayer.kt	72.69%	🟢
	PillarboxEventLogger.kt	69.92%	🟢
	PlayerCallbackFlow.kt	69.14%	🟢
	MetricsCollector.kt	65.82%	🟢
	PillarboxAnalyticsCollector.kt	64.19%	🟢
	Chapter.kt	60.87%	🟢
	Session.kt	58.12%	🟢
	PillarboxMediaSourceFactory.kt	52.3%	🟢
	DebugLogger.kt	50%	🟢
	Player.kt	43.91%	🟢
	ErrorMessageData.kt	43.33%	🟢
	PillarboxPlayer.kt	25%	🟢
	Timings.kt	18.18%	🟢
	MonitoringMessageHandler.kt	3.55%	🟢
	TrackSelectionParameters.kt	1.46%	🟢
	PlaybackService.kt	0%	🟢
	PreloadConfiguration.kt	0%	🟢
	Credit.kt	0%	🟢
	PlayerTracks.kt	0%	🟢
	PillarboxNotificationManager.kt	0%	🟢
	MessageData.kt	0%	🟢
	PlayerExtensions.kt	0%	🟢
	BitrateUtil.kt	0%	🟢
	PillarboxHttpClient.kt	0%	🟢