steelseries sonar py 다운로드 - steelseries sonar py 소스 코드 다운로드

steelseries sonar py

AI 소스 코드

1.2.0

다운로드

출판하다

steelseries sonar py API

스트리머 모드는 현재 개발 중입니다!

개요

이 Python 패키지는 SteelSeries Sonar 애플리케이션 API와 상호작용하기 위한 편리한 인터페이스를 제공합니다.
Sonar 애플리케이션을 사용하면 사용자는 다양한 오디오 채널의 볼륨을 제어하고 표시할 수 있습니다.

설치

이 패키지를 사용하려면 다음 단계를 따르세요.

pip를 사용하여 패키지를 설치합니다.
```
pip install steelseries-sonar-py
```
Python 스크립트 또는 애플리케이션에서 Sonar 클래스를 가져옵니다.
```
 from steelseries_sonar_py import Sonar 
```

용법

소나 객체 초기화

Sonar 클래스는 초기화 중에 두 가지 선택적 매개변수를 허용합니다.
streamer_mode : 스트리머 모드를 사용하려면 True로 설정합니다(기본값은 False).
app_data_path : SteelSeries Engine 3 coreProps.json 파일의 사용자 정의 경로를 지정합니다.
(기본값은 기본 설치 경로입니다: C:\ProgramData\SteelSeries\SteelSeries Engine 3\coreProps.json ).

 sonar = Sonar ( app_data_path = "C: \ path \ to \ coreProps.json" )

또는

 sonar = Sonar ( app_data_path = "C: \ path \ to \ coreProps.json" , streamer_mode = True )

스트리머 모드

steelseries sonar py python API는 streaming 및 monitoring 이라는 두 가지 별도의 슬라이더를 관리할 수 있는 스트리밍 모드를 지원합니다. 이 슬라이더를 사용하면 다양한 오디오 채널을 미세 조정할 수 있습니다.

스트리머 모드가 활성화되어 있는지 확인하려면 다음을 사용하세요.

 is_streaming = sonar . is_streamer_mode ()
print ( "Is Streamer Mode:" , is_streaming )

스트리머 모드를 활성화하거나 비활성화하려면 다음을 사용하십시오.

 # Enable streamer mode
sonar . set_streamer_mode ( True )

# Disable streamer mode
sonar . set_streamer_mode ( False )

볼륨 정보 검색

모든 채널의 현재 볼륨 설정에 대한 정보를 검색합니다.

 volume_data = sonar . get_volume_data ()
print ( volume_data )

채널 볼륨 설정

특정 채널의 볼륨을 설정합니다. channel 매개변수는 다음 중 하나여야 합니다.
master , game , chatRender , media , aux , chatCapture . volume 매개변수는 0과 1 사이의 부동 소수점이어야 합니다.
또한 선택적 streamer_slider 매개변수를 "streaming"(기본값) 또는 "monitoring" 값으로 제공할 수 있습니다.

 channel = "master"
volume = 0.75
streamer_slider = "streaming"  # or "monitoring"

result = sonar . set_volume ( channel , volume , streamer_slider = streamer_slider )
print ( result )

채널 음소거/음소거 해제

특정 채널의 음소거 상태를 전환합니다. channel 매개변수는 다음 중 하나여야 합니다.
master , game , chatRender , media , aux , chatCapture . muted 매개변수는 채널을 음소거할지( True ) 음소거 해제할지( False ) 나타내는 부울이어야 합니다.
또한 선택적 streamer_slider 매개변수를 "streaming"(기본값) 또는 "monitoring" 값으로 제공할 수 있습니다.

 channel = "game"
muted = True
streamer_slider = "monitoring"

result = sonar . mute_channel ( channel , muted , streamer_slider = streamer_slider )
print ( result )

채팅믹스

채팅 믹스 데이터 검색:

 chatmix_data = sonar . get_chat_mix_data ()
print ( chatmix_data )

game 또는 chatRender 채널의 사운드에 초점을 맞추려면 chat-mix 값을 -1 and 1 사이로 설정하십시오.

 result = sonar . set_chat_mix ( 0.5 )
print ( result )

예외

패키지에는 사용 중에 발생할 수 있는 일련의 예외가 도입되었습니다.
코드에서 적절하게 이러한 예외를 처리하는 것이 좋습니다.
steelseries_sonar_py.exceptions 에서 가져올 수 있습니다. 잠재적인 예외 목록은 다음과 같습니다.

EnginePathNotFoundError : SteelSeries Engine 3가 설치되지 않았거나 기본 위치에 없을 때 발생합니다.
ServerNotAccessibleError : SteelSeries 서버에 접근할 수 없을 때 발생합니다. HTTP 상태 코드를 제공합니다.
SonarNotEnabledError : SteelSeries Sonar가 활성화되지 않은 경우 발생합니다.
ServerNotReadyError : SteelSeries Sonar가 준비되지 않았을 때 발생합니다.
ServerNotRunningError : SteelSeries Sonar가 실행되지 않을 때 발생합니다.
WebServerAddressNotFoundError : 웹 서버 주소를 찾을 수 없을 때 발생합니다.
ChannelNotFoundError : 지정된 채널을 찾을 수 없을 때 발생합니다.
InvalidVolumeError : 잘못된 볼륨 값이 제공되면 발생합니다.
InvalidMixVolumeError : 잘못된 믹스 볼륨 값이 제공되면 발생합니다.
SliderNotFoundError : 알 수 없는 슬라이더 이름이 streamer_slider 값으로 제공되면 발생합니다.

예

다음은 steelseries sonar py thon API의 사용법을 보여주는 완전한 예입니다:

 from steelseries_sonar_py import Sonar
from steelseries_sonar_py . exceptions import EnginePathNotFoundError

# Initialize Sonar object
try :
    sonar = Sonar ( app_data_path = "C: \ path \ to \ coreProps.json" )
except EnginePathNotFoundError :
    print ( "Engine not found!" )
    quit ()

# Retrieve volume data
volume_data = sonar . get_volume_data ()
print ( "Volume Data:" , volume_data )

# Set volume for the 'master' channel
channel = "master"
volume = 0.8
streamer_slider = "streaming"
result = sonar . set_volume ( channel , volume , streamer_slider = streamer_slider )
print ( f"Set volume for { channel } :" , result )

# Mute the 'game' channel
channel = "game"
muted = True
streamer_slider = "monitoring"
result = sonar . mute_channel ( channel , muted , streamer_slider = streamer_slider )
print ( f"Mute { channel } :" , result )

# Retrieve chat-mix data
chatmix_data = sonar . get_chat_mix_data ()
print ( "Chatmix Data:" , chatmix_data )

# Set chat-mix value
result = sonar . set_chat_mix ( 0.5 )
print ( "Set Chatmix:" , result )