Making Your Apps More Sociable

Making your
apps more sociable

Copyright© 2010 Samsung Electronics, Co., Ltd. All rights reserved.

Contents
Map & Locations features
– Map control
– Location provider
– Remote landmark store
Social features
– Buddy
– SNS gateway

*This material is based on bada SDK 1.0.0b3

Copyright© 2010 Samsung Electronics, Co., Ltd. All rights reserved. 2

Map in bada


Think of this …


To do this, you need to …
Display a map
– Map control
Get my current location
– Location provider
Store information which has a location
– Database
– Landmark store (Device & Remote )


Location application essentials

Features Header Library Priv. group Priv. level
Map Control FlocationControls LOCATION_SERVICE NORMAL
Location Provider FLocations.h LOCATION NORMAL
Remote Landmark FLocations
REMOTE_LANDMARK SYSTEM
Store

You must set the privilege group:


Map in bada
1. Map control
2. Location provider
3. Remote landmark store


Getting a deCarta key
http://developer.decarta.com GO!


Using the map control (1/4)
Step 1: Set the map key for deCarta:
String extraInfo =
L"ClientName=( );ClientPassword=( );HostUrl=http://
ws.decarta.com/openls/openls";


Step 1: Set the map key for deCarta:
String extraInfo =
L"ClientName=( );ClientPassword=( );HostUrl=http://
ws.decarta.com/openls/openls";

Step 2: Create a map provider:
IMapServiceProvider* __pMapProvider;

__pMapProvider = static_cast<IMapServiceProvider*>(
ProviderManager::ConnectToServiceProviderN
(L"deCarta",LOC_SVC_PROVIDER_TYPE_MAP, extraInfo));


Step 1: Set the map key for deCarta
Step 2: Create a map provider
Step 3: Construct the map control:
__pMap = new Map();
__pMap->Construct(Rectangle(/*size*/), *__pMapProvider);


Step 1: Set the map key for deCarta
Step 2: Create a map provider
Step 3: Construct the map control:
__pMap = new Map();
__pMap->Construct(Rectangle(/*size*/), *__pMapProvider);

Step 4: Set the map control :
__pMap->SetCenter(/* latitude, longitude */, false);
__pMap->SetPanEnabled(true);


When maps are not displayed
Check that the name and
password are valid

Check the proxy if you are
in a proxy environment


Setting proxies
Run the simulator:

Menu > Settings > Connectivity >
Network > Connection > bada


Location in bada
1. Map control
3. Remote Landmark Store


Getting the position from the GPS
Step 1: Add a location update listener:
__pLocProvider = new LocationProvider();
__pLocProvider->Construct(LOC_METHOD_GPS);
__pLocProvider->RequestLocationUpdates
(/*ILocationListener &*/, 5, false);


Getting the position from the GPS
Step 1: Add a location update listener:
__pLocProvider = new LocationProvider();
__pLocProvider->Construct(LOC_METHOD_GPS);
__pLocProvider->RequestLocationUpdates
(/*ILocationListener &*/, 5, false);

Step 2: Get the position in the listener:
void MyClass::OnLocationUpdated(Location &loc)
{
const QualifiedCoordinates* pCoord =
loc.GetQualifiedCoordinates();
if (null != pCoord)
__pMap->SetCenter(*pCoord, true);
}


Location in bada
1. Map control
3. Remote landmark store


Landmarks
A landmark is a location that has a name

In bada, Landmark consists of:
Data structures

Name

Description

Coordinates

…


Landmark stores
A landmark store is a persistent database for
landmarks

Landmarks can be stored on the device or on
the bada Server

Remote landmark stores can be shared among
bada users


Accessing bada Server
You need a bada account to store landmarks on
bada Server

Samsung bada provides an easier way for sign
up and sign in:
– AppControl


AppControl
AppControl is used to start an application and
control specific behavior in it

APPCONTROL_CALENDAR APPCONTROL_DIAL APPCONTROL_MEDIA


Signing in the bada Server
AppControl* pAc =
AppManager::FindAppControlN
(APPCONTROL_SIGNIN, OPERATION_SIGNIN);

if(null != pAc) {
pAc->Start(null, this);
delete pAc;
}


Adding landmarks to a LandmarkStore

Step 1: Create a landmark:
Landmark* pLandmark = new Landmark();
pLandmark->SetQualifiedCoordinates(/* QualfiedCoor */);
pLandmark->SetName(/*name*/);
pLandmark->SetDescription(/*description*/);


Adding landmarks to a LandmarkStore

Step 1: Create a landmark:
Landmark* pLandmark = new Landmark();
pLandmark->SetQualifiedCoordinates(/* QualfiedCoor */);
pLandmark->SetName(/*name*/);
pLandmark->SetDescription(/*description*/);

Step 2: Add a landmark to a RemoteLandmarkStore:

__pServerStore = new RemoteLandmarkStore
(/*STORE NAME*/, /*IRemoteLandmarkStoreListener&*/);

__pServerStore->AddLandmark(*pLandmark, /*category*/, reqId);


Searching for landmarks (1/2)
Step 1: Request a search:
void MyApp::OnMapDrawCompleted(const Map& source)
{
RectangleGeographicArea area= source.GetViewport();
LandmarkFilter filter;
filter.SetGeographicAreaFilter(&area);

}


{

LandmarkPropertySelector selector;
selector.SetQualifiedCoordinatesSelector(true);
selector.SetDescriptionSelector(true);

}


{

LandmarkPropertySelector selector;
selector.SetQualifiedCoordinatesSelector(true);
selector.SetDescriptionSelector(true);

RequestId reqId;
__pServerStore->SearchLandmarks
(&filter, &selector, null,
SORT_ORDER_ASCENDING, SORT_BY_NAME, reqId);
}


Step 1: Request a search
Step 2: Get results:
void MyApp::OnLandmarksReceivedN(…, IList* pResults, …)
{
// implement this handler
}


Landmark Manager Demo:
Demo sequence:
– Display a map
– Search the nearby landmark
– Display the landmark information


More features for locations
Module Major Uses

Remote location Send a location to bada Server
provider Get other people’s (last known) position

Trace service Get other people’s trajectories
Map service Get a map
Directory service Search through landmarks from a service provider
Geocoding service Perform geocoding and reverse-geocoding
Route service Get a routing information from starting point to end point


When Location meets social features …


Using buddy features
Request, respond to, and delete buddies

Manage groups and friendship levels within your
buddies

Share your location, contents, or profile with
buddies


Social in bada
1. Searching profile
2. Becoming buddies
3. Sharing locations


Searching profile

1. Set profile exposure level
2. Search Mike’s profile

bada Server
3.Send 4. Respond to
buddy request buddy request


Mike: Set profile exposure level
I want to share
my location
Step 1: Create a PrivacyManager:
__privacyManager = new PrivacyManager();
__privacyManager->Construct
(IPrivacyManagerListener&);

36

Set my profile
searchable
Step 1: Create a PrivacyManager:

Step 2: Set the ProfileExposureLevel:
__privacyManager->SetProfileExposureLevel
(PROFILE_SEARCHABLE, reqId);

37

Is the set
request
Step 1: Create a PrivacyManager: successful?


Step 2: Set the ProfileExposureLevel:
__privacyManager->SetProfileExposureLevel
(PROFILE_SEARCHABLE, reqId);

Step 3: Confirm the result:
void OnProfileExposureLevelUpdated(){…}

! You must sign-in with bada account before using PrivacyManager
38

Jane: Search profile I want to find
some friends
on bada

Step 1: Construct a ProfileService:
__pProfileService = new ProfileService();
__pProfileService->Construct
(IProfileServiceListener&);


Jane: Search profile Let me try
Mike


Step 2: Search profiles:
__pProfileService->SearchProfilesByName(L”Mike”, …);
– Search by Email, LoginId, Name, PhoneNumber


Jane: Search profile Can I check
the results?


Step 2: Search profiles:
__pProfileService->SearchProfilesByName(L”Mike”, …);
– Search by Email, LoginId, Name, PhoneNumber

Step 3: Receive profiles:
void OnProfileSearchResultsReceivedN(…,
Osp::Base::Collection::IList* pBasicProfileList,…)
{…}


Social
2. Becoming buddies


Becoming buddies

1. Set profile exposure level
2. Search Mike’s profile

bada Server
3. Send a
4. Respond to buddy request
buddy request


Jane: Send a buddy request
How can I
send the
request to
Step 1: Create a BuddyService: Mike

__pBuddyService = new BuddyService();
__pBuddyService->Construct
(IBuddyServiceListener &);


Send the
request
Step 1: Create a BuddyService:

Step 2: Send a buddy request:
__pBuddyService->RequestBuddy
(/* Mikes’s UserID */, reqId);


And I can
confirm the
results
Step 1: Create a BuddyService:

Step 2: Send a buddy request:
__pBuddyService->RequestBuddy
(/* Mikes’s UserID */, reqId);

Step 3: Confirm results:
void OnBuddyRequestSent(…)
{…}


Mike: Respond to a buddy request
Is there any
buddy
Step 1: Get buddy requests: request I
received?
__pBuddyService->GetReceivedBuddyRequests(reqId);


Get the
request
Step 1: Get buddy requests: from the
server

Step 2: Receive buddy requests:
void OnReceivedBuddyRequestsReceivedN
(…,IList*pRequestList ,…)
{…}


Got Jane’s,
Step 1: Get buddy requests: Ok accept!


Step 2: Receive buddy requests:
void OnReceivedBuddyRequestsReceivedN
(…,IList*pRequestList ,…)
{…}

Step 3: Respond to buddy requests:
__pBuddyService->RespondToBuddyRequest
(*pRequest, RESPONSE_ACCEPT , reqId);


Social
2. Becoming buddies


Sharing locations

bada Server
2. Search
1. Share
Mike’s location
Mike’s location


Mike: Share a location
Can I share
my location
to my
friends?

Step 1: Set access control list for location:
__privacyManager->SetUserInfoPrivacy
(INFO_LOCATION , ACCESS_BUDDY , reqId);


Mike: Share a location Get my
current
location


Step 2: Get Mike’s location:
__pLocationProvider->RequestLocationUpdates(…);


Mike: Share a location Send my
location to
the server


Step 2: Get Mike’s location:
__pLocationProvider->RequestLocationUpdates(…);

Step 3: Register Mike’s location to bada Server:
RemoteLocationProvider::StartLocationReport(…);


MyPlace Demo:
Demo sequence:
– Display a map
– Get my friends location
– Display them on the map


The SNS Gateway


SNS gateway
The SNS gateway has unified APIs for different
SNS providers
Check the SNS provider’s features and
properties before using the SNS gateway:
Property Description Twitter Facebook
First Name The person’s given name.
Last Name The person’s family name.
Display Name The person’s display name.
User Name The person’s user name.

* MySpace will be supported in SDK b2

SNS gateway
Mike Jane

1. Sharing
2. Show my and Jane’s locations my position

bada
Server

3. Set my status
4. Get friend status
SNS Server Alice


Authentication
Step 1: Create SNS gateway
__pSnsGateway = new SnsGateway();
__pSnsGateway->Construct
(ISnsGatewayListener&, ISnsContentListener *,
ISnsPeopleListener *, ISnsActivityListener *);


Authentication
Step 1: Create SNS gateway
__pSnsGateway = new SnsGateway();
__pSnsGateway->Construct
(ISnsGatewayListener&, ISnsContentListener *,
ISnsPeopleListener *, ISnsActivityListener *);

Step 2: Login to SNS account using SNS
gateway API
__pAuthenticator = new SnsAuthenticator();
__pAuthenticator->Construct(ISnsAuthenticatorListener & );
__pAuthenticator->Authenticate
(L"twitter", /*Key*/, /*Secret*/);
…
__pSnsGateway->AddAuthResult(authResult);


Updating and getting status
Update user status:
__pSnsGateway->UpdateMyStatusText
(L”twitter”, L”Let’s meet at Starbucks”, reqId);


Updating and getting status
Update user status:
__pSnsGateway->UpdateMyStatusText
(L”twitter”, L”Let’s meet at Starbucks”, reqId);

Get friend’s status :
__pSnsGateway->GetStatusText
(L"twitter", L”Mike”, reqId);
…
void OnSnsStatusTextReceived
(..., SnsStatusText *pStatusText, ...)


SimpleTwitter Demo:
Demo sequence:
– Sing-in with the bada account
– Authenticate with the Twitter server
– Update tweets


More social features
Manage personal data on the device and server
Share and interact with other users

Device Features Server-assisted Features

•Buddy •Profile •Board
•Address •Calendar •Lifelog
Book Book

23 •Messaging •SNS Gateway

IM


Social application essentials
Features Header Library Priv. Group Priv. Level
PrivacyManager PRIVACY_SERVICE SYSTEM
ProfileService PROFILE_SERVICE SYSTEM
FSocial.h FSocialServices
BuddyService BUDDY_SERVICE SYSTEM
SnsGateway SNS_SERVICE SYSTEM


Summary


What we have learned
Locations:
– How to use the Map control
– How to get a location
– How to use a remote landmark store
– How to get other people’s locations
Social:
– How to get buddy
– How to use the SNS Gateway


Find out more: Locations
Tutorial:
– bada Tutorial.Location.pdf
Samples:
– LandmarkManager
– LocationManager
– MapControl
– MapViewer
– Navigator


Find out more: Social
Tutorial:
– bada Tutorial.Social.pdf
Samples:
– BuddyManager
– PrivacyManager
– SimpleTwitter
– TwitterOAuth


Dive into

Making Your Apps More Sociable

Recommandé

Recommandé

Contenu connexe

En vedette

En vedette (14)

Similaire à Making Your Apps More Sociable

Similaire à Making Your Apps More Sociable (20)

Making Your Apps More Sociable