Skip to content

Commit

Permalink
Merge remote-tracking branch 'origin/development'
Browse files Browse the repository at this point in the history
  • Loading branch information
dsilhavy committed May 23, 2024
2 parents 9577f94 + c8d04d6 commit 7e10462
Show file tree
Hide file tree
Showing 21 changed files with 1,614 additions and 664 deletions.
38 changes: 24 additions & 14 deletions Readme.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,26 @@
# 5GMS Media Session Handler

This repository holds the 5GMS Media Session Handler implementation of the 5G-MAG Reference Tools.
Note that currently this implementation only supports downlink media streaming.
<h1 align="center">5GMS Media Session Handler</h1>
<p align="center">
<img src="https://img.shields.io/badge/Status-Under_Development-yellow" alt="Under Development">
<img src="https://img.shields.io/github/v/tag/5G-MAG/rt-5gms-media-session-handler?label=version" alt="Version">
<img src="https://img.shields.io/badge/License-5G--MAG%20Public%20License%20(v1.0)-blue" alt="License">
</p>

## Introduction

The 5GMS Media Session Handler is a 5GMS Client component that forms part of the 5G Media Services framework as defined in
ETSI TS 126.501.
The 5GMS Media Session Handler is a 5GMS Client component that forms part of the 5G Media Services
framework as defined in ETSI TS 126.501.

### 5GMS Downlink Media Session Handler
A Media Session Handler first retrieves its configuration (“Service Access Information”) from the 5GMSd AF at reference point M5d and then uses this configuration information to activate and exploit the currently provisioned 5GMSd features. In addition, the Media Session Handler exposes APIs via M6 to the 5GMSd-Aware Application and to the
Media Player (for downlink streaming).
Additional information can be found at: https://5g-mag.github.io/Getting-Started/pages/5g-media-streaming/

#### Specifications
### 5GMS Downlink Media Session Handler

A list of specification related to this repository is available in the [Standards Wiki](https://github.com/5G-MAG/Standards/wiki/5G-Downlink-Media-Streaming-Architecture-(5GMSd):-Relevant-Specifications).
A Media Session Handler first retrieves its configuration (“Service Access Information”) from the
5GMSd AF at reference point M5d and then uses this configuration information to activate and exploit
the currently provisioned 5GMSd features. In addition, the Media Session Handler exposes APIs via M6
to the 5GMSd-Aware Application and to the
Media Player (for downlink streaming).

#### About the implementation
### About the implementation

The 5GMSd Media Session Handler is an Android application that implements functionality for 5G Media
Streaming media session handling. It is implemented as an Android Messenger Service that
Expand All @@ -36,7 +40,9 @@ git clone https://github.com/5G-MAG/rt-5gms-media-session-handler.git
```

## Install dependencies
The 5GMS-Aware Application requires the [Common Android Library](https://github.com/5G-MAG/rt-5gms-common-android-library) to run.

The 5GMS Media Session Handler requires
the [Common Android Library](https://github.com/5G-MAG/rt-5gms-common-android-library) to run.

It is included as Maven dependencies in the `build.gradle`:

Expand All @@ -46,7 +52,11 @@ dependencies {
}
````

To install the dependencies follow the installation guides in the Readme documentation of the project. Make sure to publish it as a local Maven repository:
Note that the version number (in the example above it is set to `1.0.0`) might differ depending on the
version of the 5GMS Media Session Handler.

To install the dependencies follow the installation guides in the Readme documentation of the
project. Make sure to publish it as a local Maven repository:

* [Common Android Library](https://github.com/5G-MAG/rt-5gms-common-android-library#publish-to-local-maven-repository)

Expand Down
7 changes: 5 additions & 2 deletions app/build.gradle
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ android {
minSdk 29
targetSdk 33
versionCode 1
versionName "1.1.0"
versionName "1.2.0"

testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
}
Expand All @@ -40,12 +40,15 @@ dependencies {
implementation 'com.google.android.material:material:1.8.0'
implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
implementation("com.google.android.gms:play-services-oss-licenses:17.0.1")
implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.6.4'
testImplementation 'junit:junit:4.13.2'
androidTestImplementation 'androidx.test.ext:junit:1.1.5'
androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'

implementation 'org.greenrobot:eventbus:3.3.1'

// 5GMAG
implementation 'com.fivegmag:a5gmscommonlibrary:1.1.0'
implementation 'com.fivegmag:a5gmscommonlibrary:1.2.0'

// Retrofit
def retrofit_version = "2.9.0"
Expand Down
2 changes: 1 addition & 1 deletion app/src/main/AndroidManifest.xml
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@
</activity>

<service
android:name=".MediaSessionHandlerMessengerService"
android:name=".service.MediaSessionHandlerMessengerService"
android:exported="true">
<intent-filter>
<action android:name="com.fivegmag.a5gmsmediasessionhandler.Service" />
Expand Down
4 changes: 4 additions & 0 deletions app/src/main/assets/config.properties.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<entry key="defaultServiceAccessInformationTimerInterval">10</entry>
</properties>
Loading

0 comments on commit 7e10462

Please sign in to comment.