Source code for coherence.upnp.devices.media_renderer_client
# -*- coding: utf-8 -*-
# Licensed under the MIT license
# http://opensource.org/licenses/mit-license.php
# Copyright 2006, Frank Scholz <coherence@beebits.net>
# Copyright 2018, Pol Canelles <canellestudi@gmail.com>
'''
:class:`MediaRendererClient`
----------------------------
A class representing an media renderer client device.
'''
from eventdispatcher import EventDispatcher, Property
from coherence import log
from coherence.upnp.services.clients.av_transport_client import \
AVTransportClient
from coherence.upnp.services.clients.connection_manager_client import \
ConnectionManagerClient
from coherence.upnp.services.clients.rendering_control_client import \
RenderingControlClient
[docs]class MediaRendererClient(EventDispatcher, log.LogAble):
'''
.. versionchanged:: 0.9.0
* Introduced inheritance from EventDispatcher
* The emitted events changed:
- Coherence.UPnP.DeviceClient.detection_completed =>
device_client_detection_completed
* Changed class variable :attr:`detection_completed` to benefit
from the EventDispatcher's properties
'''
logCategory = 'mr_client'
detection_completed = Property(False)
'''
To know whenever the device detection has completed. Defaults to *False*
and it will be set automatically to `True` by the class method
:meth:`service_notified`.
'''
def __init__(self, device):
log.LogAble.__init__(self)
EventDispatcher.__init__(self)
self.register_event(
'device_client_detection_completed',
)
self.device = device
self.device.bind(device_service_notified=self.service_notified)
self.device_type = self.device.get_friendly_device_type()
self.version = int(self.device.get_device_type_version())
self.icons = device.icons
self.rendering_control = None
self.connection_manager = None
self.av_transport = None
for service in self.device.get_services():
if service.get_type() in [
'urn:schemas-upnp-org:service:RenderingControl:1',
'urn:schemas-upnp-org:service:RenderingControl:2']:
self.rendering_control = RenderingControlClient(service)
if service.get_type() in [
'urn:schemas-upnp-org:service:ConnectionManager:1',
'urn:schemas-upnp-org:service:ConnectionManager:2']:
self.connection_manager = ConnectionManagerClient(service)
if service.get_type() in [
'urn:schemas-upnp-org:service:AVTransport:1',
'urn:schemas-upnp-org:service:AVTransport:2']:
self.av_transport = AVTransportClient(service)
if service.detection_completed:
self.service_notified(service)
self.info(f'MediaRenderer {device.get_friendly_name()}')
if self.rendering_control:
self.info('RenderingControl available')
'''
actions = self.rendering_control.service.get_actions()
print actions
for action in actions:
print 'Action:', action
for arg in actions[action].get_arguments_list():
print ' ', arg
'''
# self.rendering_control.list_presets()
# self.rendering_control.get_mute()
# self.rendering_control.get_volume()
# self.rendering_control.set_mute(desired_mute=1)
else:
self.warning(
'RenderingControl not available, device not implemented'
' properly according to the UPnP specification')
return
if self.connection_manager:
self.info('ConnectionManager available')
# self.connection_manager.get_protocol_info()
else:
self.warning(
'ConnectionManager not available, device not implemented'
' properly according to the UPnP specification')
return
if self.av_transport:
self.info('AVTransport (optional) available')
# self.av_transport.service.subscribe_for_variable(
# 'LastChange', 0, self.state_variable_change)
# self.av_transport.service.subscribe_for_variable(
# 'TransportState', 0, self.state_variable_change)
# self.av_transport.service.subscribe_for_variable(
# 'CurrentTransportActions', 0, self.state_variable_change)
# self.av_transport.get_transport_info()
# self.av_transport.get_current_transport_actions()
# def __del__(self):
# # print('MediaRendererClient deleted')
# pass
[docs] def remove(self):
self.info('removal of MediaRendererClient started')
if self.rendering_control is not None:
self.rendering_control.remove()
if self.connection_manager is not None:
self.connection_manager.remove()
if self.av_transport is not None:
self.av_transport.remove()
# del self
[docs] def service_notified(self, service):
self.info(f'Service {service} sent notification')
if self.detection_completed:
return
if self.rendering_control is not None:
if not hasattr(self.rendering_control.service,
'last_time_updated'):
return
if self.rendering_control.service.last_time_updated is None:
return
if self.connection_manager is not None:
if not hasattr(self.connection_manager.service,
'last_time_updated'):
return
if self.connection_manager.service.last_time_updated is None:
return
if self.av_transport is not None:
if not hasattr(self.av_transport.service, 'last_time_updated'):
return
if self.av_transport.service.last_time_updated is None:
return
self.detection_completed = True
self.dispatch_event(
'device_client_detection_completed',
client=self, udn=self.device.udn)
[docs] def state_variable_change(self, variable):
self.info('%(name)r changed from %(old_value)r to %(value)r',
vars(variable))