情景模式引擎API

最新推荐文章于 2020-01-14 16:19:55 发布

翻译最新推荐文章于 2020-01-14 16:19:55 发布 · 648 阅读

文章标签：

#api #引擎 #notifications #properties #resources #list

情景模式/铃声专栏收录该内容

11 篇文章

订阅专栏

本文介绍ProfileEngineAPI的使用方法，包括获取手机上可用配置文件列表、活动配置文件信息及其ID和铃声等属性，以及设置特定配置文件为活动状态。通过实例代码展示了如何创建和释放MProfileEngine实例，获取可用配置文件及活动配置文件详情。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Profiles Engine API
Reviewer Approved
Note!
This API is not part of the public SDK. It can be found in the SDK API Plug-in.

ProfileEngine API's are mainly used to get the list of available profiles on the mobile, get the information about the active profile, to get information of the profile change, set a profile and related information about it.

Header files
#include <mprofileengine.h>
#include <mprofilesnamesarray.h>
#include <mprofile.h>
#include <mprofilename.h>
#include <mprofiletones.h>

Link against
profileeng.lib
Capabilities required for activating new profile: WriteDeviceData

Use cases
These API's are used to show the Profiles. Also used to retrieve information of the currently Active Profile,its Id, Ringtone, MessageAlertTone. They can also be used to set a particular Profile active.

Example code

=====================================================================
Before using the API's first we create an instance of MProfileEngine using "CreateProfileEngineL()" API

MProfileEngine* lProfileEngine = CreateProfileEngineL();

Free the resources using "Release()" API

lProfileEngine->Release();

or alternatively first Push it onto CleanupStack and then PopAndDestroy()

CleanupReleasePushL( *lProfileEngine );
....
CleanupStack::PopAndDestroy();

The following code snippet is used to get the available profiles on the phone.

MProfilesNamesArray* profilesNamesArray =
                       lProfileEngine->ProfilesNamesArrayLC();
TInt lCount = profilesNamesArray->MdcaCount();

for(TInt i=0;i<lCount;i++)
    {
    TBuf<20> lName;
    lName= profilesNamesArray->ProfileName(i)->Name();
    CEikonEnv::Static()->AlertWin(_L("Available Profiles:"),lName);
    lName.Zero();
    }

CleanupStack::PopAndDestroy(profilesNamesArray);

The following code snippet is used to list the details of the Active profile and its properties like Profile Name, Id, etc.,

MProfile* lProfile = lProfileEngine->ActiveProfileL();
CleanupReleasePushL( *lProfile );

const MProfileName& lMProfileName = lProfile->ProfileName();
TBuf<10> lProfileName = lMProfileName.Name();
CEikonEnv::Static()->AlertWin(_L("Profile Name:"),lProfileName);

TInt lId = lMProfileName.Id();
TBuf<10> lProfileId;
lProfileId.AppendNum(lId);
CEikonEnv::Static()->AlertWin(_L("its Profile Id:"),lProfileId);

const MProfileTones& lMProfileTones = lProfile->ProfileTones();
TBuf<255> lProfileTone1 = lMProfileTones.RingingTone1();
CEikonEnv::Static()->AlertWin(_L("Profile Ringtone1:"), lProfileTone1);

TBuf<255> lProfileMsgalrt = lMProfileTones.MessageAlertTone();
CEikonEnv::Static()->AlertWin(_L("ProfileMsgAlrtToneName:"),lProfileMsgalrt);

CleanupStack::PopAndDestroy();