使用媒体键

 使用媒体键 

Utilising media keys
使用媒体键

Keywords (APIs, classes, methods, functions): 
CRemConInterfaceSelector
, CRemConCoreApiTarget
, MRemConCoreApiTargetObserver

Description
=====================================================================
Key presses of media keys cannot be detected in the same way as other key events. 
Media keys, such as Play/Pause, Stop, Volume Up/Down, Rewind, 
and Forward keys featured on some S60 3rd Edition devices do not generate normal key events 
that could be handled within the application framework, 
for example, in HandleKeyEventL() or OfferKeyEventL().

媒体键的按键事件，同其他按键事件，不能使用相同的方式侦测到。
媒体键，比如播放/暂停，停止，英两升高/降低，倒带，前进键，在某一些S60第三版设备上，不会产生普通的按键事件；
也不会被APP框架处理：例如:HandleKeyEventL() 或者 OfferKeyEventL().

Solution
======================================================================================
Events from media keys can be handled with the Remote Control API.
 Below is a code snippet that demonstrates this.
Remote Control API requires ReadUserData capability.

媒体键事件能被远程控制API处理，下面的代码片段演示如何做到。
远程控制API 需要ReadUserData 能力。

#include <remconcoreapitargetobserver.h>    // link against RemConCoreApi.lib
 #include <remconcoreapitarget.h>            // and
 #include <remconinterfaceselector.h>        // RemConInterfaceBase.lib
 
  class CMediaKeysTestUi : public CAknAppUi,
                           public MRemConCoreApiTargetObserver
    {
        ...
    // From MRemConCoreApiTargetObserver

    void MrccatoCommand(TRemConCoreApiOperationId aOperationId,
                         TRemConCoreApiButtonAction aButtonAct);

    // following functions from MRemConCoreApiTargetObserver are not needed
    // in this case -> use empty implementations for these:
    // MrccatoPlay
    // MrccatoTuneFunction
    // MrccatoSelectDiskFunction
    // MrccatoSelectAvInputFunction
    // MrccatoSelectAudioInputFunction                           
  private:
    CRemConInterfaceSelector* iInterfaceSelector;
    CRemConCoreApiTarget*     iCoreTarget;
    };
 
  void CMediaKeysTestUi::ConstructL()
    {
    ...
    iInterfaceSelector = CRemConInterfaceSelector::NewL();
    iCoreTarget = CRemConCoreApiTarget::NewL(*iInterfaceSelector, *this);
    iInterfaceSelector->OpenTargetL();
    }
 
  // ----------------------------------------------------------------------------
  // MrccatoCommand() 继承自MRemConCoreApiTargetObserver，接收媒体键事件
  // Receives events (press/click/release) from the following buttons:
  // ’Play/Pause’, ’Volume Up’, ’Volume Down’, ’Stop’, ’Rewind’, ’Forward’
  // ----------------------------------------------------------------------------
  void CMediaKeysTestUi::MrccatoCommand(TRemConCoreApiOperationId aOperationId,
                                        TRemConCoreApiButtonAction aButtonAct)
    {
    TRequestStatus status;
        switch( aOperationId )
        {
        case ERemConCoreApiPausePlayFunction:
            {
            switch (aButtonAct)
                {
                case ERemConCoreApiButtonPress:
                    // Play/Pause button pressed
                    break;
                case ERemConCoreApiButtonRelease:
                    // Play/Pause button released
                    break;
                case ERemConCoreApiButtonClick:
                    // Play/Pause button clicked
                    break;
                default:
                    // Play/Pause unknown action
                    break;
                }                               
            //Send the response back to Remcon server       
            iCoreTarget->PausePlayFunctionResponse(status, KErrNone);
            User::WaitForRequest(status);
            break;
            }   
 
        case ERemConCoreApiStop:
            {
            switch (aButtonAct)
                {
                // see above (case ERemConCoreApiPausePlayFunction)
                // for possible actions
                }
            iCoreTarget->StopResponse(status, KErrNone);
            User::WaitForRequest(status);
            break;
            }
        case ERemConCoreApiRewind:
            {
            switch (aButtonAct)
                {
                // see above for possible actions
                }
            iCoreTarget->RewindResponse(status, KErrNone);
            User::WaitForRequest(status);   
            break;
            }       
        case ERemConCoreApiForward:
            {
            switch (aButtonAct)
                {
                // see above for possible actions
                }
            iCoreTarget->ForwardResponse(status, KErrNone);
            User::WaitForRequest(status);
            break;
            }
        case ERemConCoreApiVolumeUp:
            {   
            switch (aButtonAct)
                {
                // see above for possible actions
                }
            iCoreTarget->VolumeUpResponse(status, KErrNone);
            User::WaitForRequest(status);   
            break;
            }       
        case ERemConCoreApiVolumeDown:
            {
            switch (aButtonAct)
                {
                // see above for possible actions
                }
            iCoreTarget->VolumeDownResponse(status, KErrNone);
            User::WaitForRequest(status);   
            break;
            }
        case ERemConCoreApiFastForward:
            {
            switch (aButtonAct)
                {
                // see above for possible actions
                }
            iCoreTarget->FastForwardResponse(status, KErrNone);
            User::WaitForRequest(status);
            break;
            }              
        case ERemConCoreApiBackward:
            {
            switch (aButtonAct)
                {
                // see above for possible actions
                }
            iCoreTarget->BackwardResponse(status, KErrNone);
            User::WaitForRequest(status);
            break;
            }                   
        default:
            break;
        }
    }

Notes: 
On most devices only volume keys can be used in 3rd party applications using this API.
在大多数设备商只有音量键能够在第三方应用程序中使用
Volume keys on accessories (for example, Nokia headsets) use different event types compared to keys on the device. 
Clients should handle ERemConCoreApiButtonClick, ERemConCoreApiButtonPress, and ERemConCoreApiButtonRelease events. 
附件上的音量键（如NOKIA头戴耳机）使用与设备上按键，不同的事件类型。
客户端需要处理  ERemConCoreApiButtonClick, ERemConCoreApiButtonPress, and ERemConCoreApiButtonRelease 事件。

When pressed and held, media keys do not automatically repeat the commands. 
If repeat functionality is required, it has to be implemented with (CPeriodic) timers. 
当按键一直按下，媒体键不能自动重复发出命令，如果需要重复功能，应该使用timer实现。